Salesforce · · 18 min read

Topics in Salesforce

How to use Salesforce Topics to organize and categorize records, enabling users to discover related content and collaborate more effectively across the org.

Welcome to Part 16 of the Salesforce series. In this post, we explore Topics — a lightweight but powerful feature that lets users tag records with keywords, making it easier to find related content, follow trends, and collaborate across the organization. Topics bridge the gap between structured data and organic discovery, giving users a flexible way to categorize and connect information without requiring custom fields or complex configurations.


What Are Topics?

Topics in Salesforce are user-defined keywords or phrases that can be attached to records and Chatter posts. Think of them as lightweight, crowdsourced labels that help organize information across the org.

When a user adds a topic to a record — say, “Q1 Launch” on an Opportunity — that topic becomes a clickable link. Clicking it takes you to a Topic Detail Page that aggregates every record and Chatter post tagged with the same topic. This creates an organic, cross-object view of related content without any reports or list views.

Key Characteristics of Topics

CharacteristicDescription
User-drivenAny user with the right permissions can create and assign topics — no admin intervention needed for day-to-day use
Cross-objectA single topic can span Accounts, Opportunities, Cases, Chatter posts, and more
SearchableTopics appear in global search results, making discovery intuitive
LightweightNo schema changes, no custom fields, no deployment — just enable and go
CollaborativeTopics tie into Chatter, so teams can follow a topic to stay updated on related conversations

Where Topics Appear in the UI

Once enabled, topics show up in several places:

  • Record Detail Pages — A “Topics” section appears near the top of the record layout (in Lightning, it typically sits below the record highlights panel). Users see pill-shaped badges for each assigned topic and can click the ”+” icon to add more.
  • Chatter Feed — When someone uses a hashtag in a Chatter post (e.g., #ProjectAlpha), Salesforce automatically creates or links to a topic. The hashtag becomes a clickable link in the feed.
  • Topic Detail Pages — Each topic has its own page that lists all tagged records, recent Chatter posts mentioning the topic, knowledgeable people, and related files.
  • Global Search — Typing a topic name into the global search bar returns the topic as a result, giving users quick access to the aggregated view.
  • List Views and Related Lists — While topics do not appear as filterable columns in standard list views, they can be used to narrow down records through search.

Topics vs. Tags (The Legacy Feature)

Salesforce once had a feature called Tags — both personal tags and public tags — that served a similar purpose. Tags were deprecated in favor of Topics, and understanding the differences helps clarify why Topics are the better choice.

FeatureTags (Legacy)Topics
StatusDeprecated (still functional in orgs where enabled, but no longer actively developed)Actively supported and integrated with Chatter
ScopePersonal tags were visible only to the creator; public tags were org-wideAll topics are org-wide and visible to anyone with access to the record
DiscoveryTags had a basic tag cloud and sidebar browsingTopics have dedicated detail pages, global search integration, and Chatter feeds
Chatter IntegrationNoneFull integration — hashtags in posts automatically create or link to topics
People & ExpertiseNot supportedTopic detail pages show “Knowledgeable People” based on activity
Auto-assignmentNot availableTopic assignment rules allow automatic tagging
API SupportLimitedFull REST and SOAP API support for topic management

Recommendation: If your org still uses legacy tags, consider migrating to Topics. There is no built-in migration tool, but you can export tag data and use Data Loader or the API to recreate them as topics.


Enabling Topics for Objects

By default, Topics may not be enabled on all objects. An administrator must explicitly turn on Topics for each object where tagging is desired.

Step-by-Step: Enable Topics for an Object

  1. Navigate to Setup (click the gear icon in Lightning Experience).
  2. In the Quick Find box, type Topics for Objects.
  3. Click Topics for Objects under the Feature Settings section.
  4. You will see a list of available objects. Select the object you want to enable topics for (e.g., Account, Contact, Opportunity, Case, or any custom object).
  5. Check the box Enable Topics for that object.
  6. Click Save.

Objects That Support Topics

Object TypeTopics Supported?
AccountsYes
ContactsYes
LeadsYes
OpportunitiesYes
CasesYes
Custom ObjectsYes
Knowledge ArticlesYes
Tasks / EventsNo
Products / Price Book EntriesNo
Reports / DashboardsNo

Note: Once topics are enabled for an object, the Topics component automatically appears on the record page layout in Lightning Experience. In Classic, you may need to add it to the page layout manually.

Things to Consider Before Enabling

  • User Adoption — Enabling topics is only useful if users actually apply them. Consider pairing the rollout with training or a communication plan.
  • Object Relevance — Not every object benefits from topics. High-volume transactional objects (like individual line items) rarely need them.
  • Governance — Without guidelines, topic names can sprawl. Decide on naming conventions before enabling broadly.

Topic Assignment Rules and Auto-Tagging

While users can manually add topics to records, Salesforce also supports Topic Assignment Rules that automatically tag records based on field values. This is especially useful for ensuring consistency and reducing the burden on end users.

How Topic Assignment Rules Work

Topic assignment rules evaluate records when they are created or edited. If a record meets the rule criteria, the specified topic is automatically applied.

Step-by-Step: Create a Topic Assignment Rule

  1. Go to Setup and search for Topic Assignment Rules in the Quick Find box.
  2. Click Topic Assignment Rules.
  3. Click New Rule.
  4. Select the Object the rule applies to (e.g., Case).
  5. Define the Topic Name — this is the topic that will be assigned when the rule fires.
  6. Set the Filter Criteria. For example:
    • Field: Case.Type
    • Operator: equals
    • Value: Billing
    • This would auto-tag any Case with Type = Billing with the topic you specified.
  7. Click Save.

Example: Auto-Tagging Cases by Type

Rule NameObjectTopic AssignedCriteria
Billing CasesCaseBilling IssuesCase Type equals “Billing”
Escalated CasesCaseEscalationsCase Priority equals “High” AND Status equals “Escalated”
Enterprise AccountsAccountEnterprise ClientsAccount Type equals “Enterprise”

Best Practices for Assignment Rules

  • Keep rules simple — Complex filter logic can be hard to maintain. If you need advanced logic, consider using Flow to assign topics instead.
  • Avoid overlapping rules — If multiple rules assign different topics to the same record, the record may end up with many auto-assigned topics that become noisy.
  • Audit periodically — Review assignment rules quarterly to ensure they still align with business terminology and processes.
  • Combine with manual tagging — Auto-tagging handles the baseline; let users add additional topics for nuance.

Topic Detail Pages

Every topic in Salesforce has a Topic Detail Page — a centralized hub that aggregates all content related to that topic. This is one of the most valuable aspects of the feature because it provides a cross-object, cross-conversation view with zero configuration.

What You See on a Topic Detail Page

SectionDescription
DescriptionA brief summary of what the topic represents (editable by users with the right permissions)
Recent RecordsA list of records tagged with the topic, grouped by object type
Chatter FeedPosts and comments that mention the topic via hashtag
Knowledgeable PeopleUsers who frequently interact with the topic — based on posting about it, being mentioned in related discussions, or tagging records with it
Related FilesFiles attached to records or Chatter posts associated with the topic

There are several ways to reach a topic detail page:

  1. Click the topic pill on any record where the topic is assigned.
  2. Click a hashtag in a Chatter post (e.g., clicking #ProjectAlpha in a feed post).
  3. Use Global Search — type the topic name in the search bar and select it from the results.
  4. Browse Topics — In some configurations, users can browse a list of all topics in the org.

Real-World Example

Imagine your company is working on a large initiative called “Project Phoenix.” By encouraging team members to tag relevant Accounts, Opportunities, Cases, and Chatter posts with the topic Project Phoenix, you create a living dashboard:

  • A sales rep can open the topic page and see all related Opportunities at a glance.
  • A support agent can find all Cases tied to the project without running a report.
  • A manager can read the Chatter feed to get context on recent discussions.
  • Anyone can see who the “Knowledgeable People” are — useful for knowing who to ask questions.

All of this happens without building a single report or dashboard.


Hashtag Topics in Chatter

Chatter and Topics are tightly integrated. When a user includes a hashtag in a Chatter post, Salesforce automatically creates a topic (if one does not already exist) and links the post to it.

How Hashtag Topics Work

  1. A user writes a Chatter post: “Great progress on the redesign! #WebsiteRelaunch”
  2. Salesforce checks if a topic named WebsiteRelaunch exists.
    • If yes, the post is linked to the existing topic.
    • If no, a new topic named WebsiteRelaunch is created and the post is linked to it.
  3. The hashtag becomes a clickable link in the feed that takes anyone to the Topic Detail Page.

Tips for Using Hashtag Topics Effectively

  • Establish conventions early — If your team starts using #website-relaunch, #WebsiteRelaunch, and #websiterelaunch interchangeably, you end up with three separate topics. Publish a list of approved topic names.
  • Use them in group posts — Hashtags in Chatter Groups help organize conversations within the group and make them discoverable org-wide.
  • Combine with @mentions — A post like “@Sarah — the client approved the proposal! #ProjectPhoenix #ClosedWon” is both a direct notification and a topic tag.
  • Monitor topic feeds — Users can follow a topic to receive notifications when new posts are tagged with it, similar to following a record.

Topics enhance Salesforce’s native search capabilities in several ways.

When a user types a topic name in the global search bar, the topic itself appears as a search result under a “Topics” category. Clicking it opens the Topic Detail Page. This is often faster than running a report or building a list view when you just need a quick cross-object view.

Topic Suggestions

Salesforce may suggest existing topics when a user starts typing in the “Add Topic” field on a record. This auto-complete behavior helps prevent duplicate topics and encourages consistency.

Following Topics

Users can follow a topic just like they follow records or people. When you follow a topic:

  • New Chatter posts tagged with that topic appear in your feed.
  • You stay informed about activity across the org related to that subject.

To follow a topic:

  1. Navigate to the Topic Detail Page.
  2. Click the Follow button.

This is particularly useful for managers, project leads, or anyone who needs to stay in the loop on a cross-functional initiative without subscribing to every individual record.


Permissions: Who Can Create and Assign Topics

Topic-related actions are controlled by a combination of user permissions and object-level access.

Key Permissions

PermissionWhat It ControlsWhere It’s Set
Assign TopicsAllows a user to add existing topics to recordsProfile or Permission Set
Create TopicsAllows a user to create new topics (not just assign existing ones)Profile or Permission Set
Delete TopicsAllows a user to delete topics from the orgProfile or Permission Set
Edit TopicsAllows a user to rename topics or edit their descriptionsProfile or Permission Set
Merge TopicsAllows a user to merge duplicate topics into oneProfile or Permission Set (available to admins)
User RoleAssignCreateEditDeleteMerge
Standard UsersYesYes (or No, if governed)NoNoNo
Team Leads / Power UsersYesYesYesNoNo
AdministratorsYesYesYesYesYes

Restricting Topic Creation

In organizations that want tight control over the topic taxonomy, you can revoke the “Create Topics” permission from standard users and grant it only to a small group of governance owners. This ensures that all topics follow approved naming conventions and reduces sprawl.

Tip: Even without the “Create Topics” permission, users with “Assign Topics” can still select from existing topics. This is the recommended approach for large organizations.


Best Practices for Topic Governance

Without governance, topics can quickly become messy — duplicate names, inconsistent capitalization, abandoned topics with no records, and a general lack of trust in the feature. Here are practical strategies to keep topics clean and useful.

Naming Conventions

GuidelineExample (Good)Example (Bad)
Use Title CaseProject Phoenixproject phoenix, PROJECT PHOENIX
Avoid abbreviations unless universally understoodCustomer OnboardingCust Onbrdng
Use singular formProduct LaunchProduct Launches
No special charactersQ1 GoalsQ1-Goals!, Q1_Goals
Keep it conciseAPAC ExpansionThe APAC Region Expansion Initiative 2026

Preventing Sprawl

  1. Publish an approved topic list — Maintain a document or Chatter post listing approved topics. Update it quarterly.
  2. Restrict creation permissions — Only allow designated users to create new topics. Others can assign from the existing list.
  3. Merge duplicates regularly — Use the Topic Merge feature (available to admins) to consolidate duplicates. For example, merge Onboarding, Customer Onboarding, and New Client Onboarding into a single canonical topic.
  4. Archive unused topics — Periodically review topics with no associated records or posts. Delete or merge them to keep the list clean.
  5. Communicate in context — When rolling out topics, add a brief note to Chatter or your internal wiki explaining what topics are, how to use them, and where to find the approved list.

Governance Checklist

  • Define naming conventions and document them
  • Decide which objects will have topics enabled
  • Set up topic assignment rules for high-value, consistent tagging
  • Configure permissions — who can create vs. only assign
  • Schedule quarterly topic audits (merge duplicates, remove unused)
  • Train users during rollout with examples relevant to their role

When Topics Are Useful vs. When They Aren’t Worth Enabling

Topics are not a universal solution. Here is a practical guide to help you decide.

When Topics Shine

ScenarioWhy Topics Help
Cross-functional projectsMultiple teams work on the same initiative across different objects — topics provide a unified view
Informal categorizationUsers need a way to group records by themes that do not map to picklist values or record types
Knowledge sharingTeams want to surface expertise — topic detail pages show “Knowledgeable People” automatically
Chatter-heavy orgsOrganizations that actively use Chatter benefit from hashtag-based discovery and topic feeds
Onboarding new employeesNew hires can browse topics to quickly understand major projects, clients, and initiatives

When Topics Are Not the Right Fit

ScenarioWhy Topics Fall Short
Reporting and analyticsYou cannot filter reports by topic. If you need to report on categorization, use a picklist field or a custom object instead
Strict, controlled taxonomiesIf the business requires a rigid, admin-controlled classification system, picklist fields with validation rules are more appropriate
Low Chatter adoptionIf your org barely uses Chatter, half the value of topics (hashtag linking, feeds, knowledgeable people) goes unrealized
High-volume, transactional recordsTagging thousands of individual order line items with topics creates noise rather than signal
Process automation triggersTopics cannot be used as criteria in workflow rules, Process Builder, or Flow. If categorization must drive automation, use fields instead

Limitations

Understanding the boundaries of Topics helps set realistic expectations.

LimitationDetails
Not available in reportsTopics cannot be used as filters, groupings, or columns in Salesforce reports
No automation triggersTopics cannot trigger workflow rules, Process Builder, flows, or approval processes
Limited object supportTasks, Events, Products, and some other standard objects do not support topics
No hierarchyTopics are flat — there is no parent-child or category-subcategory structure
Character limitTopic names have a maximum length of 150 characters
Case sensitivityTopics are case-insensitive for matching, but the display preserves the casing of the first version created. Inconsistent entry can still lead to user confusion
No bulk assignment UIThere is no native way to assign a topic to multiple records at once through the UI. You would need Data Loader or the API for bulk operations
Merge is admin-onlyOnly users with the “Merge Topics” permission (typically admins) can consolidate duplicate topics
No topic-based sharingYou cannot use topics to control record access or define sharing rules
Mobile limitationsTopic functionality in the Salesforce mobile app is more limited than in the desktop experience

Section Notes

  • Topics are a discovery and collaboration feature, not a data management feature. They complement structured fields but do not replace them.
  • The real power of topics emerges in organizations that actively use Chatter. If your org treats Chatter as optional, topics will deliver only a fraction of their potential value.
  • Topic assignment rules are underutilized in most orgs. Setting up even a handful of rules for common categories (like case types or account segments) dramatically increases the consistency and usefulness of topics.
  • Consider topics as a “low-cost, high-optional-value” feature — easy to enable, zero schema changes, and valuable for teams that embrace it, but not disruptive if some users ignore it entirely.
  • For organizations migrating from Salesforce Classic to Lightning Experience, topics work more seamlessly in Lightning. The Topics component on record pages in Lightning is more prominent and easier to use than the Classic equivalent.

Summary

Topics in Salesforce provide a flexible, user-driven way to categorize records and Chatter posts with keywords. They create cross-object views through Topic Detail Pages, surface organizational expertise through Knowledgeable People, and integrate natively with Chatter through hashtags. While they do not replace structured fields for reporting or automation, they fill an important gap for organic discovery and collaboration. With proper governance — naming conventions, permission controls, and regular audits — topics become a genuinely useful tool for connecting information across your org.


Next up — Part 17: “Reports and Dashboards in Salesforce.” We will dive into one of the most heavily used features in the platform: building reports from scratch, choosing the right report type, adding filters and groupings, creating dashboards with dynamic components, and setting up scheduled report delivery. Whether you are building your first tabular report or designing an executive dashboard, Part 17 will walk you through it all.