Demote
Demote is the Salesforce Knowledge action that reverts a published article back to draft status.
Definition
Demote is the Salesforce Knowledge action that reverts a published article back to draft status. The article disappears from agent search, the Knowledge sidebar, and public-facing community sites; authors can then revise the content and republish. Demote is a quick way to pull an article out of circulation without archiving or deleting it, typically used when an article goes out of date overnight or contains an error that the team needs to fix before customers see it.
The action is available on any published article version through the Article Actions menu in Lightning Knowledge (where it is labeled Edit as Draft) or the equivalent in Classic. The article goes back to Draft and stays editable until someone publishes a new version. Other versions of the same article remain in their original state; demote only affects the version that was live.
How demote fits the Knowledge article lifecycle
The Knowledge article lifecycle in one diagram
Knowledge articles move through Draft, Published, and Archived states. Authors create or edit drafts, publish them to make them visible, and demote or archive when they need to come down. Demote returns a published article to Draft so it can be edited and republished. Archive moves it out of circulation entirely while preserving the version history. Delete is permanent and removes the article and all its versions.
What demote does to the article record
A Knowledge article has a parent record (KnowledgeArticle) and one or more child versions (Knowledge__kav). When you demote a published article, the platform flips the IsLatestVersion and IsVisibleInPkb flags on the published version and creates an editable draft. The draft has the same content; you choose what to change before publishing again. The previously published version remains in version history for audit but is no longer the live one.
Permission requirements for demote
To demote, a user needs the Manage Articles permission and access to the data category the article belongs to. A Knowledge User license is required at all. In Lightning Knowledge, the demote action appears in the article action menu only when the user has the right permissions; if it does not appear, check the user's profile or permission sets for article-management privileges.
Demote versus Archive versus Delete
All three remove the article from active publication, but with different intent. Demote is for in-progress fixes: the article will come back, just with new content. Archive is for retirement: the article is no longer relevant, but you want to keep its history (typical for season-specific or product-end-of-life content). Delete is for genuine deletion: the article and its versions go to the Recycle Bin and then to permanent removal.
Effect on search, community visibility, and customer experience
A demoted article disappears immediately from agent search results and the Knowledge sidebar in the case feed. Public-facing community sites also stop showing it. Cached pages on the customer's browser may persist for a few minutes, but the platform's indexes refresh in real time. URLs that pointed to the article go to a Knowledge-specific 404 or redirect to a list, depending on community configuration.
Demote in a multi-language Knowledge org
Each language version of an article is a separate Knowledge__kav record. Demoting the English version does not demote the French translation or vice versa. If you need to pull an article down in all languages, you have to demote each language version individually. This is a common source of inconsistent public state in multilingual deployments.
Audit, version history, and the demoted-by user
Knowledge stores the user and timestamp for every state change, including demote. Reports on KnowledgeArticleVersion show the version history and who initiated each transition. A demoted-and-republished article carries the audit trail of both transitions, which compliance teams use to demonstrate change control on customer-facing content.
How to demote a published Knowledge article
Demoting a published article takes one click from the article detail page. The article goes back to Draft, editing resumes, and you republish when the content is ready.
- Find the article in Knowledge
Open the Knowledge app and search for the article by title or by article number. Click into the article to open its detail page in the Published state.
- Open the article actions menu
In Lightning Knowledge, the action menu sits in the top right of the article detail page. Look for a dropdown labeled Article Actions or a button labeled Edit as Draft, depending on the org's layout.
- Click Edit as Draft (or Demote in Classic)
In Lightning, the action is labeled Edit as Draft. This creates a draft version and removes the published version from circulation. In Classic, the same action is labeled Demote.
- Confirm the demotion
The platform prompts for confirmation because the change is immediately visible to end users. Confirm to proceed.
- Edit the draft
The draft opens in the editor. Make your changes, save, and confirm the draft state looks right. The article is invisible to customers and agents while in draft.
- Republish when ready
From the draft, click Publish. The new version becomes the published one; the old published version moves to version history.
The standard action label in Lightning Knowledge. Creates a new draft version of a published article.
The same action in Classic Knowledge. Reverts the published article to draft.
Use Archive when the article should not come back. Moves to archived state and preserves history.
If you change your mind before republishing, you can delete the draft; the article reverts to its previously published state.
- Demote takes effect immediately. There is no scheduling, so plan around customer-facing implications before clicking. Pull articles during low-traffic windows when possible.
- Each language version is independent. Demoting the English article leaves the French, German, and Japanese translations published. Demote each language separately if you need a global takedown.
- If the article was approved through an approval process, the draft does not require re-approval automatically. Configure your approval process to fire on Knowledge state transitions if compliance demands it.
- Demote does not delete the article. If a customer has a tab open to the URL, refreshing produces a Knowledge 404, but a Google search result may persist until the next crawl.
Trust & references
Straight from the source - Salesforce's reference material on Demote.
- Article Lifecycle in Lightning KnowledgeSalesforce Help
- Edit a Published ArticleSalesforce Help
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 does Demote do in Salesforce Knowledge?
Q2. When is Demote the right action?
Q3. What's the alternative to Demote for routine updates?
Discussion
Loading discussion…