Newer Version Available

This content describes an older version of this product. View Latest

UserProfile

Represents a Chatter user profile.

This object has been deprecated as of API version 32.0. Use the User object to query information about a user in API version 32.0 and later.

Note

Supported Calls

describeLayout(), query(), retrieve()

Special Access Rules

  • Information in hidden fields in a user's profile isn’t searchable by external users (with a portal profile) in an Experience Cloud site. For example, if a user in a site has a hidden email address and an external user searches for it, the user record isn’t returned in the search results. Hidden field values also aren’t returned when external users perform searches on nonhidden fields. So if an external user searches for a user's name (can’t be hidden), any hidden field values associated with the user record such as a hidden email address aren’t returned in the search results.

    internal users belonging to the same Experience Cloud site can search for and view hidden field values in search results.

  • Any fields that have been restricted in visibility will be returned empty, whether or not they are, and will not be removed from the field listing.

Fields

Field Details
AboutMe
Type
textarea
Properties
Filter, Nillable, Sort
Description
Information about the user, such as areas of interest or skills.
Address (beta)
Type
address
Properties
Filter, Nillable
Description
The compound form of the address. Read-only. See Address Compound Fields for details on compound address fields.
City
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The city associated with the user profile.
CompanyName
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The company associated with the user profile.
Country
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The country associated with the user profile.
Email
Type
email
Properties
Filter, Group, idLookup, Sort
Description
The email address associated with the user profile.
Fax
Type
phone
Properties
Filter, Group, Nillable, Sort
Description
The fax number associated with the user profile.
FirstName
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The user’s first name.
FullPhotoUrl
Type
url
Properties
Filter, Nillable, Sort
Description
The URL for the user's profile photo if Chatter is enabled.

The URL is updated every time a photo is uploaded and reflects the most recent photo. If a newer photo is uploaded, the URL returned for an older photo isn’t guaranteed to return a photo. Query this field for the URL of the most recent photo.

IsActive
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Indicates whether the user has access to log in (true) or not (false). You can modify a User's active status from the user interface or via the API.
IsBadged
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Indicates whether the user is visually badged (true) or not (false). Users of the same Chatter user type (internal, external) are badged. Different user types are not badged.
LastName
Type
string
Properties
Filter, Group, Sort
Description
The user’s last name.
Latitude (beta)
Type
double
Properties
Filter, Nillable, Sort
Description
Used with Longitude to specify the precise geolocation of an address. Acceptable values are numbers between –90 and 90 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations
Longitude (beta)
Type
double
Properties
Filter, Nillable, Sort
Description
Used with Longitude to specify the precise geolocation of an address. Acceptable values are numbers between –90 and 90 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations
ManagerId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
The ID of the user who manages this user.
MobilePhone
Type
phone
Properties
Filter, Group, Nillable, Sort
Description
The user’s mobile or cellular phone number.
Name
Type
string
Properties
Filter, Group, Sort
Description
Concatenation of FirstName and LastName.
Phone
Type
phone
Properties
Filter, Group, Nillable, Sort
Description
The user’s phone number.
PostalCode
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The user’s postal or ZIP code. Label is Zip/Postal Code.
SmallPhotoUrl
Type
url
Properties
Filter, Nillable, Sort
Description
The URL for a thumbnail of the user's profile photo if Chatter is enabled.

The URL is updated every time a photo is uploaded and reflects the most recent photo. If a newer photo is uploaded, the URL returned for an older photo isn’t guaranteed to return a photo. Query this field for the URL of the most recent photo.

State
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The state associated with the user profile.
Street
Type
textarea
Properties
Filter, Group, Nillable, Sort
Description
The street address associated with the user profile.
Title
Type
string
Properties
Filter, Group, Nillable, Sort
Description
The user’s business title, such as “Vice President.”
UserPreferencesActivityRemindersPopup
Type
boolean
Properties
Filter
Description
When true, a reminder window automatically opens when an activity reminder is due. Corresponds to the Trigger alert when reminder comes due checkbox at the Reminders page in the personal settings in the user interface.
UserPreferencesApexPagesDeveloperMode
Type
boolean
Properties
Filter
Description
When true, indicates that the user has enabled developer mode for editing Visualforce pages and controllers.
UserPreferencesDisableAllFeedsEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email for all updates to Chatter feeds, based on the types of feed emails and digests the user has enabled.
UserPreferencesDisableBookmarkEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone comments on a Chatter feed item after the user has bookmarked it.
UserPreferencesDisableChangeCommentEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone comments on a change the user has made, such as an update to their profile.
UserPreferencesDisableEndorsementEmail
Type
boolean
Properties
Filter
Description
When false, the member automatically receives email every time someone endorses them for a topic.
UserPreferencesDisableFeedbackEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives emails related to WDC feedback. This includes when someone requests or offers feedback, shares feedback with the user, or reminds the user to answer a feedback request.
UserPreferencesDisableFileShareNotificationsForApi
Type
boolean
Properties
Filter
Description
When false, email notifications are sent from the person who shared the file to the users that the file is shared with.
UserPreferencesDisableFollowersEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone starts following the user in Chatter.
UserPreferencesDisableLaterCommentEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone comments on a feed item after the user has commented on the feed item.
UserPreferencesDisableLikeEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone likes their post or comment.
UserPreferencesDisableMentionsPostEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time they’re mentioned in posts.
UserPreferencesDisableMessageEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email for Chatter messages sent to the user.
UserPreferencesDisableProfilePostEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone posts to the user’s profile.
UserPreferencesDisableRewardEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives emails related to WDC rewards. This includes when someone someone gives a reward to the user.
UserPreferencesDisableSharePostEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time their post is shared.
UserPreferencesDisableWorkEmail
Type
boolean
Properties
Filter
Description
When false, the user receives emails related to WDC feedback, goals, and coaching. The user must also sign up for individual emails listed on the WDC email settings page. When true, the user will not receive any emails related to WDC feedback, goals, or coaching even if they are signed up for individual emails.
UserPreferencesDisCommentAfterLikeEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone comments on a post that the user liked.
UserPreferencesDisMentionsCommentEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time the user is mentioned in comments.
UserPreferencesDisProfPostCommentEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time someone comments on posts on the user’s profile.
UserPreferencesEnableAutoSubForFeeds
Type
boolean
Properties
Filter
Description
When true, the user automatically subscribes to feeds for any objects that the user creates.
UserPreferencesEventRemindersCheckboxDefault
Type
boolean
Properties
Filter
Description
When true, a reminder popup is automatically set on the user's events. Corresponds to the By default, set reminder on Events to... checkbox on the Reminders page in the user interface. This field is related to UserPreference and customizing activity reminders.
UserPreferencesHideChatterOnboardingSplash
Type
boolean
Properties
Filter
Description
When true, the initial Chatter onboarding prompts do not appear.
UserPreferencesHideCSNDesktopTask
Type
boolean
Properties
Filter
Description
When true, the Chatter recommendations panel never displays the recommendation to install Chatter Desktop.
UserPreferencesHideCSNGetChatterMobileTask
Type
boolean
Properties
Filter
Description
When true, the Chatter recommendations panel never displays the recommendation to install Chatter Mobile.
UserPreferencesHideS1BrowserUI
Type
boolean
Properties
Filter
Description
Controls the interface that the user sees when logging in to Salesforce from a supported mobile browser. If false, the user is automatically redirected to the Salesforce mobile web. If true, the user sees the full Salesforce site. The default value is false. Label is Salesforce User.

This field is available in API version 29.0 or later.

UserPreferencesHideSecondChatterOnboardingSplash
Type
boolean
Properties
Filter
Description
When true, the secondary Chatter onboarding prompts do not appear.
UserPreferencesReminderSoundOff
Type
boolean
Properties
Filter
Description
When true, a sound automatically plays when an activity reminder is due. Corresponds to the Play a reminder sound checkbox on the Reminders page in the user interface.
UserPreferencesShowCityToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the city field in the user’s contact information. City is visible only to internal members of the user’s organization when:
  • This field is false. When false, this field returns the value #N/A.
City is visible to external members in an Experience Cloud site when:
  • This field is true, or
  • This field is false but UserPreferencesShowCityToGuestUsers is true, which overrides this field’s value.
External users are users with Community, Customer Portal, or partner portal licenses.

The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowCityToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the city field in the user’s contact information. When true, city is visible to guest users. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site. When false, this field returns the value #N/A.

When true, this field overrides the value false in UserPreferencesShowCityToExternalUsers, making the user’s city visible to external members.

The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowCountryToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the country field in the user’s contact information. Country is visible only to internal members of the user’s organization when:
  • This field is false. When false, this field returns the value #N/A.
Country is visible to external members in an Experience Cloud site when:
  • This field is true, or
  • This field is false but UserPreferencesShowCountryToGuestUsers is true, which overrides this field’s value.
External users are users with Community, Customer Portal, or partner portal licenses.

The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowCountryToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the country field in the user’s contact information. When true, country is visible to guest users. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site. When false, this field returns the value #N/A.

When true, this field overrides the value false in UserPreferencesShowCountryToExternalUsers, making the user’s country visible to external members.

The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowEmailToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the email address field in the user’s contact information. Email address is visible only to internal members of the user’s organization when this field is false. Email address is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowFaxToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the fax number field in the user’s contact information. Fax number is visible only to internal members of the user’s organization when this field is false. Fax number is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowManagerToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the manager field in the user’s contact information. Manager is visible only to internal members of the user’s organization when this field is false. Manager is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowMobilePhoneToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the mobile device number field in the user’s contact information. The number is visible only to internal members of the user’s organization when this field is false. The number is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowPostalCodeToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the postal or ZIP code field in the user’s contact information. Postal code is visible only to internal members of the user’s organization when:
  • This field is false. When false, this field returns the value #N/A.
Postal code is visible to external members in an Experience Cloud site when:
  • This field is true, or
  • This field is false but UserPreferencesShowPostalCodeToGuestUsers is true, which overrides this field’s value.
External users are users with Community, Customer Portal, or partner portal licenses.

The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowPostalCodeToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the postal or ZIP code field in the user’s contact information. When true, postal code is visible to guest users. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site. When false, this field returns the value #N/A.

When true, this field overrides the value ​false in UserPreferencesShowPostalCodeToExternalUsers, making the user’s postal code visible to external members.

The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowProfilePicToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the user’s profile photo. When true, the photo is visible to guest users in an Experience Cloud site. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site.

When false, this field returns the stock photo. The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowStateToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the state field in the user’s contact information. State is visible only to internal members of the user’s organization when:
  • This field is false. When false, this field returns the value #N/A.
State is visible to external members in an Experience Cloud site when:
  • This field is true, or
  • This field is false but UserPreferencesShowStateToGuestUsers is true, which overrides this field’s value.
External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowStateToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the state field in the user’s contact information. When true, state is visible to guest users. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site. When false, this field returns the value #N/A.

When true, this field overrides the value false in UserPreferencesShowStateToExternalUsers, making the user’s state visible to external members.

The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowStreetAddressToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the street address field in the user’s contact information. The address is visible only to internal members of the user’s organization when this field is false. The address is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesShowTitleToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the business title field in the user’s contact information. Title is visible only to internal members of the user’s organization when:
  • This field is false. When false, this field returns the value #N/A.
Title is visible to external members in an Experience Cloud site when:
  • This field is true, or
  • This field is false but UserPreferencesShowTitleToGuestUsers is true, which overrides this field’s value.
External users are users with Community, Customer Portal, or partner portal licenses.

The default value is true. This field is available in API version 26.0 and later.

UserPreferencesShowTitleToGuestUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the business title field in the user’s contact information. When true, title is visible to guest users. Guest users can access public Site.com and Salesforce sites, and public pages in Experience Cloud sites, via the Guest User license associated with each site. When false, this field returns the value #N/A.

When true, this field overrides the value false in UserPreferencesShowTitleToExternalUsers, making the user’s title visible to external members.

The default value is false. This field is available in API version 28.0 and later.

UserPreferencesShowWorkPhoneToExternalUsers
Type
boolean
Properties
Filter
Description
Indicates the visibility of the work phone number field in the user’s contact information. The number is visible only to internal members of the user’s organization when this field is false. The number is visible to external members in an Experience Cloud site when this field is true. External users are users with Community, Customer Portal, or partner portal licenses.

When false, this field returns the value #N/A. The default value is false. This field is available in API version 26.0 and later.

UserPreferencesTaskRemindersCheckboxDefault
Type
boolean
Properties
Filter
Description
When true, a reminder popup is automatically set on the user's tasks. Corresponds to the By default, set reminder on Tasks to... checkbox on the Reminders page in the user interface. This field is related to UserPreference and customizing activity reminders.

Usage

Use this object to query Chatter—related information about the user. While the User object contains all the information about a user and is historically tied to user management, UserProfile is a read-only entity that contains the information that is relevant in a Chatter context.

Associated Objects

This object has the following associated objects. Unless noted, they are available in the same API version as this object.

UserProfileFeed (API version 18.0–26.0)
Feed tracking is available for the object.