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:

This resource type provides access to the following operations.

Manage Delve accessibility:

  • Determine whether a user and the user's organization have access to Office Delve.
  • Disable or enable documents in Office Delve for specific users.

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

  • Determine whether a user's item and meeting hours insights are enabled.
  • Disable or enable item and meeting hours insights for specific user.

Manage user's locale-based preferences:

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

Manage users' work shift preferences:

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

Configure contactMergeSuggestions:

  • Determine whether suggestions to merge duplicate contacts for a user is enabled.
  • Disable or enable suggestions to merge duplicate contacts for a user.

Export users' Windows settings and values stored in a cloud:

Inherits from entity.


This endpoint works only with the user resource.


Method Return Type Description
Get settings userSettings Get the user and organization settings.
Update settings userSettings Update the user current settings.
List windowsSetting collection Get the windowsSetting objects and their properties for the signed in user.


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.
windows windowsSetting collection The Windows settings of the user stored in the cloud.

JSON representation

The following JSON representation shows the resource type.

  "contributionToContentDiscoveryDisabled": false,
  "contributionToContentDiscoveryAsOrganizationDisabled": false