Knowledge Sidebar
The Knowledge Sidebar is the Lightning component that surfaces Salesforce Knowledge articles inside the Service Console, sitting in the right rail of the case page and the chat console.
Definition
The Knowledge Sidebar is the Lightning component that surfaces Salesforce Knowledge articles inside the Service Console, sitting in the right rail of the case page and the chat console. It runs an auto-suggest query against the case Subject and Description (or against active chat keywords), ranks matching articles, and presents the top results inline with attach, send, and link actions. Agents see relevant articles without leaving the case context, attach them with one click, and increment article view and ranking counters automatically.
The Knowledge Sidebar is the agent-facing surface that turns Salesforce Knowledge from a library into a deflection engine. Without it, agents have to navigate to the Knowledge tab, search manually, find an article, copy its content, and paste into the case. With the Sidebar, the article is suggested as soon as the case opens, attached with a click, and shared with the customer through email or chat. The productivity difference is meaningful at scale; a Service Cloud team with the Sidebar configured typically deflects 30 to 50 percent more cases through Knowledge than a team without it.
How the Knowledge Sidebar surfaces articles to agents inline
Where the Knowledge Sidebar appears
The Knowledge Sidebar is configured through Lightning App Builder. Open the case Lightning record page, drag the Knowledge Component into the right rail. The same component is available on the Service Console chat page, the Live Agent chat surface, and any custom Lightning page that benefits from contextual article suggestions. Mobile uses a touch-optimized version of the same component. The configuration is per-page, so different page layouts can show different Knowledge Sidebar configurations.
Auto-suggest: how article matching works
The Sidebar runs an auto-suggest query against the case Subject and Description when the case loads. The query uses the same engine as Global Search: full-text matching, synonym expansion, promoted search term application. The result is a ranked list of articles with the most likely match at the top. Agents can refine the query manually by typing in the Sidebar search bar; the refined search overrides the auto-suggestion. Most modern Service Cloud deployments rely on auto-suggest as the primary article discovery path.
Article actions: attach, share, link
Each suggested article in the Sidebar has action buttons. Attach links the article to the case (creating a CaseArticle record) and increments the article view stats. Share Article inserts the article as a Knowledge link in the active email or chat publisher, customer-facing. Link copies the article URL for pasting elsewhere. Each action runs without leaving the Sidebar; the agent stays in the case context. Some configurations expose additional actions like Mark Helpful, Open in New Tab, or custom Quick Actions on the article.
View counts and ranking signal
Each article attached or shared through the Sidebar increments KnowledgeArticleViewStat counters. The view data feeds the article ranking algorithm; high-attach articles rise in future searches. This is why agent behavior shapes search quality over time: agents who attach articles teach the platform which content is useful. Agents who copy-paste content instead of attaching bypass the loop and slow the ranking improvement. Train agents to use Attach, not copy-paste.
Filters and search refinement in the Sidebar
The Sidebar exposes filters that narrow the suggested articles. Filter by Data Category (Product = Cloud, Region = USA), by Record Type (FAQ only, How-To only), or by Article Language. The filters compose with the auto-suggested query. For multilingual orgs, the language filter is critical; without it, agents see Spanish articles for English customers. Configure the default filter set per page through Lightning App Builder; the Sidebar component supports filter defaults.
Mobile and the Field Service variant
Mobile users see a stripped-down Sidebar adapted for touch. The actions are the same (Attach, Share, Link) with touch-friendly buttons and a compact result list. Field Service technicians using the Salesforce Field Service mobile app see the Knowledge Sidebar inline with the work order, suggesting troubleshooting articles based on the work order subject. The integration is automatic for Field Service deployments using Lightning Knowledge.
Customizing the Sidebar with Lightning Components
The standard Knowledge Sidebar covers most use cases, but custom Lightning Web Components can extend it. A custom component might call a custom Apex method that combines Knowledge search with external content sources (Confluence, SharePoint), or that filters articles by criteria the standard Sidebar does not support (article popularity over the last 7 days only). The Knowledge Sidebar API is documented in the Salesforce developer guide and accessible through the lightning/uiRecordApi modules.
Adding the Knowledge Sidebar to the Service Console
Configuring the Knowledge Sidebar is a Lightning App Builder activity: drop the component on the right page, configure the auto-suggest fields and default filters, save and activate.
- Enable Lightning Knowledge first
Setup, Knowledge Settings, confirm Lightning Knowledge is enabled. Without it, the Knowledge Sidebar component does not appear in the Lightning App Builder palette.
- Open the case Lightning record page
Setup, Object Manager, Case, Lightning Record Pages. Edit the default page or clone for the Service Console.
- Drag the Knowledge component into the right rail
The component appears in the Standard category. Drag it to the right rail or another suitable region.
- Configure auto-suggest fields
On the component properties, pick which case fields drive the auto-suggest query (Subject, Description, Type). Most teams default to Subject + Description.
- Set default filters
Configure default Data Category filters and Record Type filters. For multilingual orgs, set the default language filter to the case Account language.
- Activate the page
Save and activate as the default for the Service Console app. The Sidebar appears for every user assigned to the page layout.
- Repeat for chat and other surfaces
Add the Knowledge component to the chat console page, the messaging console page, and any custom Service Cloud surface where agents work with cases.
- Train agents on Attach vs copy-paste
The view-count and ranking signal depends on Attach. Train agents to click Attach, not copy-paste, when sharing article content with customers.
The case fields used to generate the article suggestion query. Subject + Description is the typical default.
Data Category and Record Type filters applied to the auto-suggest results. Configurable per page.
For multilingual orgs, the language used to filter articles. Critical for non-English customer support.
Attach, Share, Link buttons exposed on each suggested article. Custom Quick Actions can be added.
Touch-optimized version of the Sidebar that surfaces on the Salesforce Mobile App and Field Service mobile.
- The Knowledge Sidebar requires Lightning Knowledge enabled. Classic Knowledge orgs have a different Sidebar component with reduced functionality.
- Auto-suggest matches against the configured fields only. A case with empty Subject and Description gets no suggestions; ensure the case creation flow populates these fields.
- Without a language filter, multilingual orgs serve mixed-language articles to agents. Set the default language explicitly.
- Copy-paste of article content bypasses the view counter and ranking signal. Train agents to Attach instead.
- Custom Lightning components extending the Sidebar need to honor the Knowledge sharing model. Bypassing the model risks exposing articles to users who should not see them.
Trust & references
Straight from the source - Salesforce's reference material on Knowledge Sidebar.
- Knowledge SidebarSalesforce Help
- Lightning Knowledge in the Service ConsoleSalesforce Help
- Lightning Knowledge OverviewSalesforce Help
Hands-on resources to go deeper on Knowledge Sidebar.
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 was the Knowledge Sidebar?
Q2. What replaces Knowledge Sidebar in Lightning?
Q3. Should you use Knowledge Sidebar today?
Discussion
Loading discussion…