Skip to content
Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
DictionaryTTopics
Core CRMBeginner

Topics

Topics in Salesforce are tag records that group related content (Chatter posts, files, Knowledge articles, and records on most standard and custom objects) under a shared label so users can find and follow conversations and information that share a theme.

§ 01

Definition

Topics in Salesforce are tag records that group related content (Chatter posts, files, Knowledge articles, and records on most standard and custom objects) under a shared label so users can find and follow conversations and information that share a theme. A Topic record stores the name, a description, optional related topics, and the list of objects it has been applied to.

The feature spans Chatter (Topics on posts and groups), Knowledge (Topics on articles), Files (Topics on uploads), and standard objects through the Topics for Objects switch. Each application of a Topic to a record creates a TopicAssignment junction record, which is the underlying data model that drives Topic feeds, related-topic recommendations, and topic-based reporting.

§ 02

How Topics fit into Chatter, Knowledge, Files, and standard objects

Topic, TopicAssignment, and the underlying data model

Salesforce models Topics as first-class records on the Topic standard object. Each Topic has a Name (the public label), a Description, a CreatedBy user, and a list of related-topic links. Connections between a Topic and the records it has been applied to live in the TopicAssignment object, a junction record that holds the topic id and the parent record id (a feed item, an article, a file, or any record of a Topics-enabled object). This junction is what makes a single Topic visible across Chatter feeds, the Knowledge article list, and the records on standard objects. Reporting on Topics almost always starts with TopicAssignment, since that is the table that joins everything together.

Topics for Objects and the enable switch

Topics are not on by default for every object. Setup, Feature Settings, Chatter, Topics for Objects has a checkbox per standard and custom object that controls whether users can apply Topics to that object records. The most common ones enabled are Account, Contact, Lead, Opportunity, Case, Knowledge Article, and Files. Once enabled, a Topics field appears in the record detail page footer, and users can type or select Topics. Disabling Topics on an object hides the field but does not delete the underlying TopicAssignment records, which can resurface if the feature is re-enabled later. Decide upfront which objects benefit from Topics and which add UI noise without value.

Topics in Chatter, Knowledge, and Files

Each surface uses Topics slightly differently. In Chatter, Topics are typed inline as hashtags in post text, and the platform automatically creates or attaches the matching Topic record. In Knowledge, Topics are applied through a separate Topic Assignment UI on the article detail page, since Knowledge content is more structured than a Chatter post. In Files, Topics are applied through a tag-style picker when uploading or sharing. All three write to the same TopicAssignment junction, but the entry point and the UI affordance differ. Training users on the right entry point per surface is the most common Topics adoption issue.

Topic Moderation and the role of Topic Moderators

Topic Moderation is a permission (Modify Topics) that lets designated users merge spelling variants of the same Topic, retire stale Topics, hide off-topic Topics, and write descriptions that help users find the right Topic. Without active moderation, the Topic list grows by accretion: every misspelled hashtag becomes a separate Topic, and the resulting list is too noisy to navigate. Assign a small team as Topic Moderators (usually Communications, Knowledge Managers, or Operations) and give them a one-line SLA: merge variants within one business day, retire Topics with no activity in the last six months. This keeps the Topic list usable and protects the feed-of-related-topics recommendations from drift.

Topic-based reporting and the related-topic graph

Reports on Topics live on the TopicAssignment object. Common reports are: most-used Topics in the last 30 days, Topics with no activity in the last quarter, Topics by user (which contributors are tagging what), and Topics by record type. The platform also maintains a related-topic graph by analyzing which Topics frequently co-occur on the same records or in the same Chatter posts. This graph drives the Related Topics card on the Topic detail page and the suggested-Topic recommendations when a user is typing in a post. The graph rebuilds over time, so newly created Topics need a few days of activity before they show up in recommendations.

Topics versus Tags versus Categories

Salesforce has three classification concepts that overlap in confusing ways. Tags are an older personal-classification feature that lets each user attach their own tags to records; tags are not shared across users. Categories are a Knowledge-specific hierarchical classification used for article browsing and visibility. Topics are the modern, shared, flat classification used across Chatter, Knowledge, Files, and most objects. New work should use Topics. Tags are kept around for backward compatibility but get no new investment. Categories are still required for Knowledge article visibility (data categories) and remain the right tool there. Document the difference in the org admin guide so newer admins do not duplicate the same content in all three.

§ 03

Configuring Topics so they stay useful over time

Setting up Topics is a three-layer configuration: enable the feature on the right objects, write a starter list of canonical Topics, and assign Topic Moderators with the Modify Topics permission. The platform handles record creation and the TopicAssignment junction automatically, so the work is less about wiring things up and more about deciding which objects to enable, what the canonical Topic list looks like, and who maintains it. Skip the third step and the Topic list fills with one-off variants within a quarter.

  1. Enable Topics for the right objects

    Open Setup, search Topics for Objects, and check the boxes for objects where Topics will add value. Common picks are Account, Contact, Lead, Opportunity, Case, Knowledge Article, and Files. Resist the temptation to enable Topics on every object. Each enabled object adds a Topics field to the detail page and a small amount of cognitive load for users. Save the change and test the field appears on a sample record. If Lightning page layouts have been customized, you may also need to add the Topics component to the record page through App Builder.

  2. Write a starter list of canonical Topics

    Pick 20 to 50 Topics that the org cares about and create them up front rather than letting them emerge organically. Common categories are product lines (one Topic per product), customer segments (Enterprise, Mid-Market, SMB), regions (North America, EMEA, APAC), and project codes (one Topic per major initiative). Add a description to each Topic so users understand which one to pick. Publish the list in a place every employee can find. Refresh it quarterly to retire stale entries and add Topics for new initiatives, since the alternative is the list growing by user-typed variants.

  3. Assign Topic Moderators and write a merge SLA

    Designate three to five users as Topic Moderators by granting the Modify Topics permission through a permission set. Their job is to merge spelling variants of the same Topic into a canonical record, retire Topics with no recent activity, and hide off-topic or spam Topics from search results. Write a one-line SLA for the team, such as merge variants within one business day so the related-topic graph does not get polluted. Track the moderation queue in a Chatter group or a simple custom list view so handovers between moderators stay clean and visible.

  4. Add the Topics component to high-traffic Lightning pages

    Use Lightning App Builder to add the Topics component to the record pages where Topics matter (Account, Opportunity, Case, Knowledge Article). The component shows the Topics applied to the current record and lets users add or remove Topics inline. On the home page, add a Topic Trends card so users see which Topics are gaining activity. On the global search results page, configure Topic-aware filters so a user searching for a Topic name sees both Topic records and records tagged with that Topic, not just keyword matches.

Gotchas
  • Disabling Topics on an object hides the field but does not delete the TopicAssignment records. They resurface if the feature is re-enabled. Plan a deletion pass if you truly want them gone.
  • Topics are case-insensitive but display-case-sensitive. A Topic created as Q4Results displays as Q4Results, but a lowercase hashtag in a post attaches to the same Topic. Pick a casing convention and stick to it.
  • Spelling variants count as different Topics until a moderator merges them. Without a merge SLA, the Topic list grows to thousands of entries within a year, most of them near-duplicates.
  • The related-topic graph rebuilds over time. A newly created Topic needs a few days of activity before it shows up in recommendations, so do not expect instant suggestions on fresh Topics.
  • Topics, Tags, and Categories solve different problems and are not interchangeable. Standardize new work on Topics; keep Categories for Knowledge data category visibility; retire Tags from new processes.
§

Trust & references

Official documentation

Straight from the source - Salesforce's reference material on Topics.

Was this entry helpful?
Help us write better definitions. Quick reactions or detailed edit suggestions.

About the Author

Dipojjal Chakrabarti is a B2C Solution Architect with 29 Salesforce certifications and over 13 years in the Salesforce ecosystem. He runs salesforcedictionary.com to help admins, developers, architects, and cert/interview candidates sharpen their fundamentals. More about Dipojjal.

§

Test your knowledge

Q1. What are Topics?

Q2. How do they differ from groups?

Q3. How do you create a topic?

§

Discussion

Loading…

Loading discussion…