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 is not searchable by external users (with a portal profile) in a community. For example, if a user in a community has a hidden email address and an external user searches for it, the user record is not returned in the search results. Hidden field values are also not returned when external users perform searches on non-hidden fields. So if an external user searches for a user's name (cannot be hidden), any hidden field values associated with the user record (for example, a hidden email address) are not returned in the search results.

    Internal users from your organization who belong to the same community, however, can both 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. The URL returned for an older photo is not guaranteed to return a photo if a newer photo has been uploaded. You should always 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 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
Longitude (beta)
Type
double
Properties
Filter, Nillable, Sort
Description
Used with Latitude to specify the precise geolocation of an address. Acceptable values are numbers between –180 and 180 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
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. The URL returned for an older photo is not guaranteed to return a photo if a newer photo has been uploaded. You should always 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 popup 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 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 Work.com 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 has shared a file to the users with whom the file has been shared.
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 a post or comment the user has made.
UserPreferencesDisableMentionsPostEmail
Type
boolean
Properties
Filter
Description
When false, the user automatically receives email every time the user is 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 Work.com 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 the user’s post is shared.
UserPreferencesDisableWorkEmail
Type
boolean
Properties
Filter
Description
When false, the user receives emails related to Work.com feedback, goals, and coaching. The user must also sign up for individual emails listed on the Work.com email settings page. When true, the user will not receive any emails related to Work.com 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 the user has 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 a community 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 Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community. 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 a community 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 Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community. 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 a community 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 a community 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 a community 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 or cellular 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 a community 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 a community 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 Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community. 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 a community. Guest users can access public Site.com and Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community.

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 a community 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 Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community. 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 a community 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 a community 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 Force.com sites, and public pages in Communities, via the Guest User license associated with each site or community. 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 a community 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.