Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

TopicAssignment

Represents the assignment of a topic to a specific feed item, record, or file. This object is available in API version 28.0 and later.

Administrators must enable topics for objects before users can add topics to records of that object type. Topics for most objects are available in API version 30.0 and later. Topics for ContentDocument are available in API version 37.0 and later.

Supported Calls

create(), describeSObjects(), delete(), getDeleted(), getUpdate(), query(), retrieve()

Fields

Field Name	Details
EntityId	Type reference Properties Create, Filter, Group, Sort Description Identifier of the feed item, record, or file. This is a polymorphic relationship field. Relationship Name Entity Relationship Type Lookup Refers To Account, Asset, Campaign, Case, Contact, ContentDocument, Contract, Event, FeedItem, Lead, Opportunity, Order, ProductItem, ProductItemTransaction, ProductRequest, ProductRequestLineItem, ProductRequired, ProductTransfer, ResourceAbsence, ResourcePreference, ReturnOrder, ReturnOrderLineItem, ServiceAppointment, ServiceResource, ServiceResourceSkill, ServiceTerritory, ServiceTerritoryMember, Shift, Shipment, Solution, Task, WorkOrder, WorkOrderLineItem
EntityKeyPrefix	Type string Properties Filter, Group, idLookup, Sort Description The first three digits of the EntityID field, which identify the object type (account, opportunity, etc). This read-only field is available in API version 32.0 and later. Interface label is “Record Key Prefix,” which appears only in reports.
EntityType	Type string Properties Filter, Group, Nillable, Sort Description The standard name for the object type (account, opportunity, etc). This read-only field is available in API version 33.0 and later. Querying topic assignments for the ManagedContentVersion entity type isn’t supported. Note Interface label is “Object Type,” which appears only in reports. In most cases, you should use this field rather than EntityKeyPrefix, which exists primarily to support older reports. Tip
NetworkId	Type reference Properties Create, Filter, Group, Nillable, Sort Description Identifier of the community to which the TopicAssignment belongs. This field is available only if digital experiences is enabled in your org.
TopicId	Type reference Properties Create, Filter, Group, Sort Description Identifier of the topic. This is a relationship field. Relationship Name Topic Relationship Type Lookup Refers To Topic

Usage

Use this object to query the assignments of topics to feed items, records, or files. To assign or remove topics, you must have the “Assign Topics” permission.

In SOQL SELECT syntax, this object supports nested semi-joins, allowing queries on Knowledge articles assigned to specific topics. For example:

1SELECT parentId FROM KnowledgeArticleViewStat
2    WHERE parentId in (SELECT KnowledgeArticleId FROM KnowledgeArticleVersion
3    WHERE publishStatus = 'Online' AND language = 'en_US'
4    AND  Id in (select EntityId from TopicAssignment where TopicId ='0T0xx0000000xxx'))

There is no SOQL limit if the logged-in user has the “View All Data” permission. If they do have that permission, do one of the following:

Specify a LIMIT clause of 1,100 records or fewer.
Filter on Id or Entity when using a WHERE clause with "=".

Deleting this object's records removes all its data. This action is irreversible.

Important

When you create a report type on the TopicAssignment object, all queries are generated in SQL, which does not enforce the 1,100 record limit clause.

Note

Object Reference for the Salesforce Platform

TopicAssignment

Supported Calls

Fields

Usage

See Also