--- schema_version: "1" id: 8a33ed5a3d00661646e914d8b822c3f5f51523e59e64412303d77ba255fe1e81 title: RecentlyViewed collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_recentlyviewed.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_recentlyviewed.htm source_site: developer.salesforce.com content_type: documentation content_hash: ebc5800842c4a657153604f1074e4a66a2382d2b1cfda00668cf867424ad9b1a description: Represents records or list views that the current user has recently viewed or referenced (by viewing a related record). List views are available in API version 29.0 and later. --- # RecentlyViewed Represents records or list views that the current user has recently viewed or referenced (by viewing a related record). List views are available in API version 29.0 and later. ## Supported Calls describeSObjects(), query(), update() ## Special Usage Rules The RecentlyViewed object doesn’t support the Event, Task, Report, KnowledgeArticle, and Article objects. The RecentlyViewed object supports only certain objects, and supports list views only for those supported objects. Supported objects have the fields LastReferencedDate and LastViewedDate. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note RecentlyViewed records for users who are members of several communities can’t be retrieved automatically into a map via Apex. This is because records of a user with different networks can result in duplicate IDs that maps don’t support. ## Fields | Field | Details | | --- | --- | | Alias | Type string Properties Filter, Group, Nillable, Sort Description The alias on the record. | | Email | Type email Properties Filter, Group, Nillable, Sort Description The email address on the record. | | FirstName | Type string Properties Filter, Group, Nillable, Sort Description The first name on the record. If the recently viewed record is a user, the value is the user’s first name. | | Id | Type ID Properties Defaulted on create, Filter, Group, Sort Description The ID of the recently viewed record or list view. | | IsActive | Type boolean Properties Defaulted on create, Filter, Group, Sort Description Indicates whether the recently viewed record is an active user (true) or not (false). This field contains a value only if the recently viewed record is a user. | | LastName | Type string Properties Filter, Group, Nillable, Sort Description The last name on the record. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort, Update Description The timestamp when the current user last interacted with this record, directly or indirectly. - Viewing or opening a record. - Selecting a record in a lookup search or related list search. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort, Update Description The timestamp when the current user last viewed this record or list view. If this value is null, it’s possible that the user only accessed this record or list view (LastReferencedDate), but not viewed it. | | Name | Type string Properties Filter, Group, Nillable, Sort Description The name on the recently viewed record or list view. If the recently viewed record is a user, contact, or lead, the value is a concatenation of the firstname and lastname field values. | | NetworkId | Type reference Properties Filter,Group, Nillable, Sort Description ID of the Experience Cloud site that this group is part of. This field is available only if digital experiences is enabled in your org. You can add a NetworkId only when creating a group. You can’t change or add a NetworkId for an existing group. This field is available in API version 27.0 and later. | | Phone | Type phone Properties Filter, Group, Nillable, Sort Description The phone number on the record. | | ProfileId | Type reference Properties Filter, Group, Nillable, Sort Description If the recently viewed record is a user, this value is the user’s profile ID. This field is a relationship field. Relationship Name Profile Relationship Type Lookup Refers To Profile | | Title | Type string Properties Filter, Group, Nillable, Sort Description If the recently viewed record is a user, this value is the title of the user; for example CFO or CEO. | | Type | Type picklist Properties Filter, Group, Nillable, Restricted picklist, Sort Description The object type for this recently viewed record or list view. Valid values include any standard or custom objects that RecentlyViewed supports. | | UserRoleId | Type reference Properties Filter, Group, Nillable, Sort Description The ID of the user role associated with this object. This field is a relationship field. Relationship Name UserRole Relationship Type Lookup Refers To UserRole | ## Usage This object provides a heterogeneous list of different object types. The list consists of recently viewed records, records that were recently referenced (a related record was viewed), or recently viewed list views. A record is considered viewed when the user sees the record details, but not when the user sees the record in a list with other records. Use this object to programmatically construct a list of recently viewed items specific to the current user. For example, use this object on a custom user interface or for search auto-complete options. You can also retrieve a filtered list of records by object type (Type). The RecentlyViewed data is periodically truncated down to 200 records and 200 list views. RecentlyViewed data is retained for 90 days, after which it’s removed on a periodic basis. Use this query in your code to retrieve a list of all the records and list views that were recently viewed. The results are ordered from most to least recent. SELECT Id, Name FROM RecentlyViewed WHERE LastViewedDate !=null ORDER BY LastViewedDate DESC Use this query to retrieve data that was either viewed or referenced, but only for a limited set of objects. SELECT Id, Name FROM RecentlyViewed WHERE Type IN ('Account', 'Contact', 'Plan\_\_c') ORDER BY LastViewedDate DESC This query retrieves a list of all recently viewed contacts with contact-specific fields, such as the contact’s account name, and the custom website field. Records are ordered from most to least recent. SELECT Account.Name, Title, Email, Phone, Website\_\_c FROM Contact WHERE LastViewedDate != NULL ORDER BY LastViewedDate DESC