Article Publication
Article Publication is the lifecycle event that moves a Salesforce Knowledge Article from Draft (or from being recalled) into Online status, making it visible to its assigned channels.
Definition
Article Publication is the lifecycle event that moves a Salesforce Knowledge Article from Draft (or from being recalled) into Online status, making it visible to its assigned channels. The act of publishing changes the PublishStatus field, locks the previous version's content for that article, and exposes the new version to search, the Knowledge sidebar, Help Center sites, and any other surface that respects the Knowledge index. Publication is the moment the content actually starts helping agents and customers; before publication, the article exists only as a working draft.
Publication can be triggered manually by an author or Knowledge manager, programmatically via Apex and the Knowledge API, or by a scheduled job that publishes drafts hitting a future-dated effective date. Each path produces the same outcome: a new KnowledgeArticleVersion record with PublishStatus = Online, the prior Online version (if any) replaced atomically, and the article surfaced to its configured channels. The platform also fires Knowledge-specific automation hooks on publication, letting Flows, Apex triggers, and Einstein for Knowledge react to the new content. Most organisations centralise publication through a review-and-publish workflow rather than letting individual authors publish freely.
How Article Publication moves Knowledge from draft to live
The publish action and its effects
Publishing sets PublishStatus to Online on the KnowledgeArticleVersion. The previous Online version, if any, is replaced atomically. Search indexes refresh; the Knowledge sidebar and Experience Cloud Help Center surface the new version. Inbound links to the article's URL continue to resolve because the URL Name stays stable across versions.
Manual versus scheduled publication
Manual publication happens from the Article Manager or the article's edit page; the user clicks Publish. Scheduled publication uses a future-dated effective date on the draft; a platform job picks up the draft on the chosen day and publishes it automatically. Scheduled publication is useful for release-aligned content (publish on the day the new feature ships, not before).
Approval workflows around publication
Knowledge programs typically gate publication behind an approval process. Authors submit drafts; reviewers approve; only then does the publish action run. Salesforce supports this through the standard Approval Process feature, with the publish step often automated as a Final Approval Action. The gating is what keeps low-quality or pre-release content out of customer-facing surfaces.
Versioning and what publish replaces
Each publish creates a new version. The article's previous Online version is preserved in version history; it just no longer appears in search. Knowledge managers can revert by publishing an older version (effectively making it the new Online version). Version history is the audit trail that lets compliance teams confirm which version was live when.
Channel visibility and audience effects
Publish exposes the article only to the channels checked on the article (Internal App, Customer, Partner, Public Knowledge Base). An article missing the Customer channel is published to internal agents but invisible on the public Help Center. Channel visibility is per article, per version; checking the wrong box is the most common publication mistake.
Translation publication flow
Articles can be published with translations. The master article publishes first, then each language version follows. Salesforce can publish the master and queue translations for later, or publish them together. Most multilingual programs publish in a wave: master article first, then translations as they are completed, with the translated versions linked to the master via the language code.
Programmatic publication via the Knowledge API
The PublishStatus field can be updated via Apex or the REST API, which is how external content systems push articles into Salesforce. Most ISVs that integrate with Salesforce Knowledge (translation tools, content management systems) call the Knowledge API to publish articles after content is finalised externally.
Post-publish reporting and signals
Once published, an article accumulates view counts, votes, search-result clickthrough rates, and Case attachment counts. The first 30 days post-publish is the highest-signal window for whether the article will succeed. Reports that track publish-to-views latency and first-week engagement let Knowledge teams identify articles that should be promoted, revised, or archived early.
How to publish a Knowledge Article cleanly
Publication is one click. The discipline that makes Knowledge programs work is what happens around the click: review, validation, audience targeting, and post-publish monitoring.
- Open the article draft
From Article Manager, find the draft and open it. Confirm the content, Data Category assignments, and channel checkboxes match the intent.
- Submit for review if the org requires it
Most production programs route drafts through approval. The author clicks Submit for Approval; reviewers approve before the publish action runs.
- Click Publish
Once approved (or directly if approvals are not required), click Publish. The article moves to Online status and surfaces to its channels.
- Validate the live article
Search for the title in the Knowledge sidebar or the Experience Cloud Help Center. Confirm the article appears for the intended audience. Fix channel visibility immediately if missing.
- Monitor views and engagement
Track views, votes, and Case attachments in the first 30 days. Early signal usually predicts long-term value; weak signal means the article needs revision or promotion.
- Channel visibility is per article and per version. Articles missing the right channel are silently invisible to that audience.
- Publishing replaces the prior Online version atomically. Inbound links continue to resolve because URL Name is preserved.
- Scheduled publication relies on a future-dated effective date and the platform job. Confirm the date in the article's local timezone.
- Translations have their own publish state. Publishing the master does not automatically publish all translations.
Trust & references
Cross-checked against the following references.
- Publish Knowledge ArticlesSalesforce Help
- Knowledge Articles OverviewSalesforce Help
Straight from the source - Salesforce's reference material on Article Publication.
- Create Knowledge ArticlesSalesforce 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 Article Publication do?
Q2. Which channels can articles be published to?
Q3. What does scheduled publication let you do?
Discussion
Loading discussion…