Skip to main content

Create, Link, and Maintain Help Center Articles - Article

Write complete guidance, use the rich-text tools and select publication metadata. Maintain stable article URLs, useful navigation and a clear distinction between drafts and published content.
Updated: 18 Nov 2026
6 min read

Summary

An effective article helps a person understand a situation, choose the right action and recognize a successful result. Accurate context is as important as the instructions, especially when users are customers or partners who cannot see how your organization works internally.

The Help Center combines rich article content with a Topic, audience, separate FAQs and Related articles. Maintain these elements together so saving a well-written page also produces a dependable reader journey.

Use this article to:

  • Create complete articles with the correct Topic and audience
  • Use links, files, images and structured formatting appropriately
  • Save drafts, publish deliberately and maintain existing destinations

Find the article you need to maintain

Open Content management → Articles as a Help Center administrator. Search by article name, filter by Topic or use No topic to find unassigned content. The Status filter separates All, Published and Unpublished material. More records load as you move through the list; the first visible batch is not necessarily the full collection.

Before creating an article, check whether an existing article already owns the process. Updating that article retains the URL used in course guidance, messages and bookmarks. Create a new article when it answers a distinct task or decision, not simply because the process has changed.

Create an article and set its metadata

Select Create in the Articles list. Prepare the body and metadata together, then choose the intended save action.

FieldWhat to provide and why
TitleA recognizable task or question; use the terms your audience would search for
DescriptionA concise explanation of the reader benefit and scope for article listings
ContentThe explanation, procedure, examples and outcome checks the reader needs
TopicThe maintained navigation home; select it explicitly rather than relying on a default
RolesAt least one intended reader audience; multiple selections widen access
FAQ questionsExisting reusable FAQ records that answer relevant follow-up questions
Related articlesA few strongly relevant cross-topic destinations for the article as a whole

The Description is separate from the article body. A useful body opens with purpose and scope, explains prerequisites and choices, then gives instructions in the order the reader performs them. Add a focused troubleshooting section when recurring exceptions require diagnosis. Keep FAQs in their separate records rather than repeating the complete set in the body.

Use the editor to make the explanation readable

Use headings to create a clear hierarchy and meaningful sections. The article title already identifies the page; use the available heading levels for the body rather than making ordinary paragraphs look like headings with bold text alone.

Tool or groupAppropriate use and consequence
Paragraph and headingsStructure the explanation so readers and content retrieval can locate the relevant section
Bold, italic, underline and text stylingEmphasize a meaningful control or distinction; avoid formatting entire paragraphs or table columns for decoration
Bulleted and numbered listsUse bullets for parallel choices and numbering for an actual sequence
TablesCompare fields, choices or symptoms with their meanings; balance column widths for the content
Callouts and quotesSeparate important boundaries or quoted material without replacing the main explanation
Links, images, media and dividersProvide the relevant destination or visual where it supports a task
Undo, Redo and Remove formatRecover an edit or remove unwanted pasted styling
SourceEdit HTML source; other formatting controls are unavailable until you leave Source mode

In Source mode, enter HTML rather than Markdown. Return to the formatted view before saving and inspect the whole article, including tables, links and images. Pasted or source-edited content can be sanitized by the editor; a successful paste does not prove that the intended layout has been retained.

Link to articles, files and external destinations

The Link dialog provides Link, File and Article routes. Use Link for an appropriate web destination, File for a supporting upload accepted by the dialog, and Article to select a maintained Help Center destination. Give each link descriptive text that explains what the reader will find.

The Article picker can include drafts. Check that the destination is published and available to the intended reader before releasing the source article. A link does not bypass the target’s audience restrictions: an unavailable target can produce an access error, while a deleted target produces a missing-page error.

For the controlled document collection, use Configure and Maintain Resource Library Access and Documents. Apply the readability and accessible-media principles in Create Accessible and Mobile-Friendly Learning Content when preparing informative content.

Use a file attachment when it is a relevant companion to the explanation. For a controlled collection of manuals, SOPs or product documentation distributed by training relationships, use the Resource Library and its own access model. Do not treat an article’s inline file upload as equivalent to that managed document service.

Add informative visuals

Place screenshots or diagrams beside the decision or step they explain. Include meaningful alternative text and a caption that states the takeaway. Use realistic examples and current interfaces; exclude credentials, private contact information and unnecessary environment details from images.

A screenshot can show orientation and exact controls, while a diagram can explain a relationship that no single page reveals. Keep the written procedure complete so the reader does not have to infer a rule from a picture. Recheck visuals whenever the interface or process changes.

Save, review and publish deliberately

  1. Select Save draft while the article is being prepared. Confirm the saved article is marked Unpublished draft.
  2. Reopen it and verify the full content, Description, Topic, Roles, FAQs, Related articles and images. Review links as the intended audience, not only as a Help Center administrator.
  3. Select Publish when the article is ready for its selected readers. Publication makes the article available through the applicable reader routes; it is not an internal approval request.
  4. For later changes, open the existing article’s edit action, make the scoped correction and verify the saved publication state. Do not create a replacement URL for an ordinary update.

If an article must be retired, check its incoming links first. Deleting it does not automatically repair links from other articles or courses. Preserve useful knowledge in its authoritative destination and update the affected references before removing a page.

Verify the saved result

Scenario or checkExpected result or evidence
The article is reopened after savingThe complete text and selected metadata match the intended version
A permitted reader opens the published articleThe layout, links, FAQs and navigation support the task
A linked file or article is openedThe destination is correct and available to the intended reader
A draft is retained for editorial workIt remains unpublished rather than appearing as current guidance
An existing article is updatedIts established URL continues to serve the corrected content

Troubleshooting

ProblemWhat to check
The content looks different after pasteUse Undo or Remove format as appropriate, inspect Source if needed and verify the complete formatted result before saving
A linked article gives an access errorCheck its publication state and Roles; the Article picker can include drafts
A link reaches a missing pageCheck whether the target was deleted and update the source link to the current authoritative destination
The article appears under an unexpected TopicEdit the article, select its intended Topic explicitly and save the correct state
A draft seems absent from reader searchDrafts are editorial material; published, eligible content supplies reader results

FAQ