usersettings EntityType

User's preferred settings.

Entity Set Path
[organization URI]/api/data/v9.0/usersettingscollection
Base Type
crmbaseentity
Display Name
User Settings
Primary Key
systemuserid
Operations Supported
GET PATCH

Properties

Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
addressbooksyncinterval Edm.Int32

Normal polling frequency used for address book synchronization in Microsoft Office Outlook.

advancedfindstartupmode Edm.Int32

Default mode, such as simple or detailed, for advanced find.

amdesignator Edm.String

AM designator to use in Microsoft Dynamics 365.

autocaptureuserstatus Edm.Int32

Set user status for ADC Suggestions

autocreatecontactonpromote Edm.Int32

Auto-create contact on client promote

businessunitid Edm.Guid

Unique identifier of the business unit with which the user is associated.

calendartype Edm.Int32

Calendar type for the system. Set to Gregorian US by default.

createdon Edm.DateTimeOffset

Date and time when the user settings object was created.

Read Only
currencyformatcode Edm.Int32

Information about how currency symbols are placed in Microsoft Dynamics 365.

currencysymbol Edm.String

Symbol used for currency in Microsoft Dynamics 365.

datavalidationmodeforexporttoexcel Edm.Int32

Information that specifies the level of data validation in excel worksheets exported in a format suitable for import.

Display Name: Data Validation Mode For Export To Excel

Default Options
Value Label
0 Full
1 None
dateformatcode Edm.Int32

Information about how the date is displayed in Microsoft Dynamics 365.

dateformatstring Edm.String

String showing how the date is displayed throughout Microsoft 365.

dateseparator Edm.String

Character used to separate the month, the day, and the year in dates in Microsoft Dynamics 365.

decimalsymbol Edm.String

Symbol used for decimal in Microsoft Dynamics 365.

defaultcalendarview Edm.Int32

Default calendar view for the user.

defaultcountrycode Edm.String

Text area to enter default country code.

Display Name: Default Country Code

defaultdashboardid Edm.Guid

Unique identifier of the default dashboard.

defaultsearchexperience Edm.Int32

Default search experience for the user.

Display Name: Default Search Experience

Default Options
Value Label
2 Use last search
0 Relevance search
1 Categorized search
3 Custom search
entityformmode Edm.Int32

Indicates the form mode to be used.

Display Name: Form Mode

Default Options
Value Label
0 Organization default
1 Read-optimized
2 Edit
fullnameconventioncode Edm.Int32

Order in which names are to be displayed in Microsoft Dynamics 365.

getstartedpanecontentenabled Edm.Boolean

Information that specifies whether the Get Started pane in lists is enabled.

Default Options
Value Label
1 Yes
0 No
helplanguageid Edm.Int32

Unique identifier of the Help language.

homepagearea Edm.String

Web site home page for the user.

homepagelayout Edm.String

Configuration of the home page layout.

homepagesubarea Edm.String

Web site page for the user.

ignoreunsolicitedemail Edm.Boolean

Information that specifies whether a user account is to ignore unsolicited email (deprecated).

Default Options
Value Label
1 Yes
0 No
incomingemailfilteringmethod Edm.Int32

Incoming email filtering method.

Display Name: Incoming Email Filtering Method

Default Options
Value Label
0 All email messages
1 Email messages in response to Dynamics 365 email
2 Email messages from Dynamics 365 Leads, Contacts and Accounts
3 Email messages from Dynamics 365 records that are email enabled
4 No email messages
isappsforcrmalertdismissed Edm.Boolean

Show or dismiss alert for Apps for 365.

Display Name: Show alert for Apps for 365.

Default Options
Value Label
1 Yes
0 No
isautodatacaptureenabled Edm.Boolean

Indicates whether to use the Auto Capture feature enabled or not.

Default Options
Value Label
1 Yes
0 No
isdefaultcountrycodecheckenabled Edm.Boolean

Enable or disable country code selection .

Display Name: Enable Default Country Code

Default Options
Value Label
1 Yes
0 No
isduplicatedetectionenabledwhengoingonline Edm.Boolean

Indicates if duplicate detection is enabled when going online.

Default Options
Value Label
1 Yes
0 No
isemailconversationviewenabled Edm.Boolean

Enable or disable email conversation view on timeline wall selection.

Default Options
Value Label
1 Yes
0 No
isguidedhelpenabled Edm.Boolean

Enable or disable guided help.

Display Name: Enable Default Guided Help

Default Options
Value Label
1 Yes
0 No
isresourcebookingexchangesyncenabled Edm.Boolean

Indicates if the synchronization of user resource booking with Exchange is enabled at user level.

Display Name: Resource booking synchronization enabled

Default Options
Value Label
1 Enabled
0 Disabled
issendasallowed Edm.Boolean

Indicates if send as other user privilege is enabled or not.

Default Options
Value Label
1 Yes
0 No
lastalertsviewedtime Edm.DateTimeOffset

Shows the last time when the traces were read from the database.

localeid Edm.Int32

Unique identifier of the user locale.

longdateformatcode Edm.Int32

Information that specifies how Long Date is displayed throughout Microsoft 365.

modifiedon Edm.DateTimeOffset

Date and time when the user settings object was last modified.

Read Only
negativecurrencyformatcode Edm.Int32

Information that specifies how negative currency numbers are displayed in Microsoft Dynamics 365.

negativeformatcode Edm.Int32

Information that specifies how negative numbers are displayed in Microsoft Dynamics 365.

nexttrackingnumber Edm.Int32

Next tracking number.

numbergroupformat Edm.String

Information that specifies how numbers are grouped in Microsoft Dynamics 365.

numberseparator Edm.String

Symbol used for number separation in Microsoft Dynamics 365.

offlinesyncinterval Edm.Int32

Normal polling frequency used for background offline synchronization in Microsoft Office Outlook.

outlooksyncinterval Edm.Int32

Normal polling frequency used for record synchronization in Microsoft Office Outlook.

paginglimit Edm.Int32

Information that specifies how many items to list on a page in list views.

personalizationsettings Edm.String

For internal use only.

pmdesignator Edm.String

PM designator to use in Microsoft Dynamics 365.

reportscripterrors Edm.Int32

Picklist for selecting the user preference for reporting scripting errors.

Display Name: Report Script Errors

Default Options
Value Label
1 Ask me for permission to send an error report to Microsoft
2 Automatically send an error report to Microsoft without asking me for permission
3 Never send an error report to Microsoft about Microsoft Dynamics 365
resourcebookingexchangesyncversion Edm.Int64

The version number for resource booking synchronization with Exchange.

Display Name: User resource booking synchronization version

selectedglobalfilterid Edm.Guid

Store selected customer service hub dashboard saved filter id.

showweeknumber Edm.Boolean

Information that specifies whether to display the week number in calendar displays in Microsoft Dynamics 365.

Default Options
Value Label
1 Yes
0 No
splitviewstate Edm.Boolean

For Internal use only

Default Options
Value Label
1 Expanded
0 Collapsed
synccontactcompany Edm.Boolean

Indicates if the company field in Microsoft Office Outlook items are set during Outlook synchronization.

Default Options
Value Label
1 Yes
0 No
systemuserid Edm.Guid

Unique identifier of the user.

timeformatcode Edm.Int32

Information that specifies how the time is displayed in Microsoft Dynamics 365.

timeformatstring Edm.String

Text for how time is displayed in Microsoft Dynamics 365.

timeseparator Edm.String

Text for how time is displayed in Microsoft Dynamics 365.

timezonebias Edm.Int32

Local time zone adjustment for the user. System calculated based on the time zone selected.

timezonecode Edm.Int32

Local time zone for the user.

timezonedaylightbias Edm.Int32

Local time zone daylight adjustment for the user. System calculated based on the time zone selected.

timezonedaylightday Edm.Int32

Local time zone daylight day for the user. System calculated based on the time zone selected.

timezonedaylightdayofweek Edm.Int32

Local time zone daylight day of week for the user. System calculated based on the time zone selected in Options.

timezonedaylighthour Edm.Int32

Local time zone daylight hour for the user. System calculated based on the time zone selected.

timezonedaylightminute Edm.Int32

Local time zone daylight minute for the user. System calculated based on the time zone selected.

timezonedaylightmonth Edm.Int32

Local time zone daylight month for the user. System calculated based on the time zone selected.

timezonedaylightsecond Edm.Int32

Local time zone daylight second for the user. System calculated based on the time zone selected.

timezonedaylightyear Edm.Int32

Local time zone daylight year for the user. System calculated based on the time zone selected.

timezonestandardbias Edm.Int32

Local time zone standard time bias for the user. System calculated based on the time zone selected.

timezonestandardday Edm.Int32

Local time zone standard day for the user. System calculated based on the time zone selected.

timezonestandarddayofweek Edm.Int32

Local time zone standard day of week for the user. System calculated based on the time zone selected.

timezonestandardhour Edm.Int32

Local time zone standard hour for the user. System calculated based on the time zone selected.

timezonestandardminute Edm.Int32

Local time zone standard minute for the user. System calculated based on the time zone selected.

timezonestandardmonth Edm.Int32

Local time zone standard month for the user. System calculated based on the time zone selected.

timezonestandardsecond Edm.Int32

Local time zone standard second for the user. System calculated based on the time zone selected.

timezonestandardyear Edm.Int32

Local time zone standard year for the user. System calculated based on the time zone selected.

trackingtokenid Edm.Int32

Tracking token ID.

uilanguageid Edm.Int32

Unique identifier of the language in which to view the user interface (UI).

usecrmformforappointment Edm.Boolean

Indicates whether to use the Microsoft Dynamics 365 appointment form within Microsoft Office Outlook for creating new appointments.

Default Options
Value Label
1 Yes
0 No
usecrmformforcontact Edm.Boolean

Indicates whether to use the Microsoft Dynamics 365 contact form within Microsoft Office Outlook for creating new contacts.

Default Options
Value Label
1 Yes
0 No
usecrmformforemail Edm.Boolean

Indicates whether to use the Microsoft Dynamics 365 email form within Microsoft Office Outlook for creating new emails.

Default Options
Value Label
1 Yes
0 No
usecrmformfortask Edm.Boolean

Indicates whether to use the Microsoft Dynamics 365 task form within Microsoft Office Outlook for creating new tasks.

Default Options
Value Label
1 Yes
0 No
useimagestrips Edm.Boolean

Indicates whether image strips are used to render images.

Default Options
Value Label
1 Yes
0 No
userprofile Edm.String

Specifies user profile ids in comma separated list.

versionnumber Edm.Int64
Read Only
visualizationpanelayout Edm.Int32

The layout of the visualization pane.

Display Name: Visualization Pane Layout.

Default Options
Value Label
0 Top-bottom
1 Side-by-side
workdaystarttime Edm.String

Workday start time for the user.

workdaystoptime Edm.String

Workday stop time for the user.

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_createdby_value createdby

Unique identifier of the user who created the user settings.

_createdonbehalfby_value createdonbehalfby

Unique identifier of the delegate user who created the usersettings.

_modifiedby_value modifiedby

Unique identifier of the user who last modified the user settings.

_modifiedonbehalfby_value modifiedonbehalfby

Unique identifier of the delegate user who last modified the usersettings.

_transactioncurrencyid_value transactioncurrencyid

Unique identifier of the default currency of the user.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
businessunitid_businessunit businessunit business_unit_user_settings
createdby systemuser lk_usersettingsbase_createdby
createdonbehalfby systemuser lk_usersettings_createdonbehalfby
modifiedby systemuser lk_usersettingsbase_modifiedby
modifiedonbehalfby systemuser lk_usersettings_modifiedonbehalfby
systemuserid_systemuser systemuser user_settings
transactioncurrencyid transactioncurrency transactioncurrency_usersettings

Solutions

The following solutions include the usersettings entity type.

Name Description
System Solution Internal CRM System Solution

See also