userSettings resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Settings that represent a user’s preferences for the following:

Manage Delve accessibility:

  • Checking whether a user and the user's organization have access to Office Delve.
  • Disabling or enabling documents in Office Delve for specific users.

Configure the visibility of itemInsights and meeting hours insights. ItemInsights are derived between users and other items (such as documents or sites) in Microsoft 365:

  • Checking whether a user's item and meeting hours insights are enabled.
  • Disabling or enabling item and meeting hours insights for specific user.

Manage user's locale-based preferences:

  • Determining what language and regional formatting a user prefers to view applications with.
  • Updating a user's language and regional formatting preferences.

Manage user's work shift preferences:

  • Checking whether a user can be assigned to shifts in a schedule.
  • Updating a user's shift preferences.

Configure contactMergeSuggestions:

  • Determining whether suggestion to merge duplicate contacts for a user is enabled.
  • Disabling or enabling suggestion to merge duplicate contacts for a user.

Inherits from entity. To learn how to get or update user settings, see Get settings and Update settings.


This endpoint works only with the user resource.


Method Return Type Description
Get user settings userSettings Get the user and organization settings.
Update user settings userSettings Update the user current settings.


Property Type Description
contributionToContentDiscoveryDisabled Boolean When set to true, documents in the user's Office Delve are disabled. Users can control this setting in Office Delve.
contributionToContentDiscoveryAsOrganizationDisabled Boolean Reflects the Office Delve organization level setting. When set to true, the organization doesn't have access to Office Delve. This setting is read-only and can only be changed by administrators in the SharePoint admin center.
id String Unique identifier of the user setting. Read-only. Inherited from entity.


Relationship Type Description
contactMergeSuggestions contactMergeSuggestions The user's settings for the visibility of merge suggestion for the duplicate contacts in the user's contact list.
itemInsights userInsightsSettings The user's settings for the visibility of meeting hour insights, and insights derived between a user and other items in Microsoft 365, such as documents or sites. Get userInsightsSettings through this navigation property.
regionalAndLanguageSettings regionalAndLanguageSettings The user's preferences for languages, regional locale and date/time formatting.
shiftPreferences shiftPreferences The shift preferences for the user.

JSON representation

Here is a JSON representation of the resource.

  "contributionToContentDiscoveryDisabled": false,
  "contributionToContentDiscoveryAsOrganizationDisabled": false