UserPreference | Object Reference for the Salesforce Platform

Supported Calls

create(), delete(), describeSObjects(), query(), retrieve(), update(), upsert()

Special Access Rules

Customer Portal users can't access this object.

Only users with the View All Data or Manage Users permission can access UserPreference records of other users but all users can access their own UserPreference record.

This behavior does not affect other types of user access such as Create or Edit.

Note

Fields

Field	Details
Preference	Type picklist Properties Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update Description The name of the user preference. Supported values are: `57` (Event Reminder Default Lead Time) `58` (Task Reminder Default Time) `91` (Prevent Logs on Load) `92` (Autocomplete Apex After Key Press) `93` (Visualforce Viewstate Inspector) `94` (Forecasting Displayed Type) `96` (Editor Theme) `97` (Editor Font Size) `98` (Pinned Folders) `99` (Enable Query Plan) `100` (Enable New Open Dialog) `101` (Email Transport Type) `102` (Pinned Wave Folders) `108` (Density) `109` (Lightning Flow Builder) `111` (Format with Tabs) `112` (Format Tab Width) `113` (Format Print Width) `114` (Record Page Activities Display) `118` (Lightning Flow Explorer) `119` (For internal use only) `120` (Simple Auth Option) `122` (Sales Alert Notifications Snooze Time) `Event Reminder Default Lead Time` and `Task Reminder Default Time` are related to these fields on the User object: UserPreferencesEventRemindersCheckboxDefault UserPreferencesTaskRemindersCheckboxDefault UserPreferencesSuppressEventSFXReminders UserPreferencesSuppressTaskSFXReminders `Enable New Open Dialog` is reserved for future use. When creating SOQL queries, `tolabel` is required to return accurate results. For example, `select Id, tolabel(Preference), Value, UserId from UserPreference`. `108` (Density) is available in API v44.0 and later.
UserId	Type reference Properties Create, Filter, Group, Sort, Update Description The ID of the user associated with this role. The corresponding field label is User ID. Admin users can create and edit preferences for other users. Standard users can delete their own preferences only. For a standard user, the value of the UserId field must be their own UserId.
Value	Type textarea Properties Create, Filter, Nillable, Sort, Update Description The value of the user preference. For `Event Reminder Default Lead Time`, the values are increasing intervals of time from 0 minutes to 2 days. For Task Reminder Default Time, the values are half-hours from 12:00 AM to 11:30 PM. To view the respective sets of values, access the Reminders in your personal settings in the online application.

Field

Details

Preference

Type

picklist

Properties

Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update

Description

The name of the user preference. Supported values are:

57 (Event Reminder Default Lead Time)
58 (Task Reminder Default Time)
91 (Prevent Logs on Load)
92 (Autocomplete Apex After Key Press)
93 (Visualforce Viewstate Inspector)
94 (Forecasting Displayed Type)
96 (Editor Theme)
97 (Editor Font Size)
98 (Pinned Folders)
99 (Enable Query Plan)
100 (Enable New Open Dialog)
101 (Email Transport Type)
102 (Pinned Wave Folders)
108 (Density)
109 (Lightning Flow Builder)
111 (Format with Tabs)
112 (Format Tab Width)
113 (Format Print Width)
114 (Record Page Activities Display)
118 (Lightning Flow Explorer)
119 (For internal use only)
120 (Simple Auth Option)
122 (Sales Alert Notifications Snooze Time)

Event Reminder Default Lead Time and Task Reminder Default Time are related to these fields on the User object:

UserPreferencesEventRemindersCheckboxDefault
UserPreferencesTaskRemindersCheckboxDefault
UserPreferencesSuppressEventSFXReminders
UserPreferencesSuppressTaskSFXReminders

Enable New Open Dialog is reserved for future use.

When creating SOQL queries, tolabel is required to return accurate results. For example, select Id, tolabel(Preference), Value, UserId from UserPreference.

108 (Density) is available in API v44.0 and later.

UserId

Type: reference
Properties: Create, Filter, Group, Sort, Update
Description: The ID of the user associated with this role. The corresponding field label is User ID.; Admin users can create and edit preferences for other users.; Standard users can delete their own preferences only. For a standard user, the value of the UserId field must be their own UserId.

Value

Type: textarea
Properties: Create, Filter, Nillable, Sort, Update
Description: The value of the user preference. For Event Reminder Default Lead Time, the values are increasing intervals of time from 0 minutes to 2 days. For Task Reminder Default Time, the values are half-hours from 12:00 AM to 11:30 PM. To view the respective sets of values, access the Reminders in your personal settings in the online application.

Usage

Use this object to query the set of currently configured user preferences in your organization. In your client application, you can query the User object to obtain valid User IDs to access the UserPreference object.

All users can invoke the supported calls with this object. Standard users can invoke these calls, but only on their own preferences.

Login

Products

Experiences

Agentforce

CRM Products

Industries

Small Business

Data

Salesforce Platform

Customer Success

Partner Apps & Experts

Discover the #1 AI CRM

Discover the #1 AI CRM

Automotive

Communications

Engineering, Construction & Real Estate

Consumer Goods

Education

Energy & Utilities

Financial Services

Healthcare & Life Sciences

Manufacturing

Media

Nonprofit

Professional Services

Public Sector

Retail

Technology

Travel, Transportation & Hospitality

Explore Salesforce for industries.

Explore Salesforce for industries.

Customer Stories

Salesforce on Salesforce Stories

Trailblazer Stories

Explore success stories.

Explore success stories.

Learning on Trailhead

Events

Resources

Blogs

Become a Trailblazer.

Become a Trailblazer.

Help & Documentation

Communities

Services & Plans

Account Management

Questions? We can help.

Questions? We can help.

About Salesforce

Our Values

Our Impact

Careers

Newsroom

Legal

More Salesforce Brands

Hear our story.

Hear our story.

Events

Trending

Industries

My List

Explore Salesforce+.

Explore Salesforce+.

Login

Products

Experiences

Contact Us

By phone

Online

Products

Experiences

Developer Centers

Salesforce Platform

Industries

Resources

Developer Tools

Build Skills

Extend Salesforce

Stay Up To Date

Community