Create, Link, and Maintain Help Center Articles - Article
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.
| Field | What to provide and why |
|---|---|
| Title | A recognizable task or question; use the terms your audience would search for |
| Description | A concise explanation of the reader benefit and scope for article listings |
| Content | The explanation, procedure, examples and outcome checks the reader needs |
| Topic | The maintained navigation home; select it explicitly rather than relying on a default |
| Roles | At least one intended reader audience; multiple selections widen access |
| FAQ questions | Existing reusable FAQ records that answer relevant follow-up questions |
| Related articles | A 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 group | Appropriate use and consequence |
|---|---|
| Paragraph and headings | Structure the explanation so readers and content retrieval can locate the relevant section |
| Bold, italic, underline and text styling | Emphasize a meaningful control or distinction; avoid formatting entire paragraphs or table columns for decoration |
| Bulleted and numbered lists | Use bullets for parallel choices and numbering for an actual sequence |
| Tables | Compare fields, choices or symptoms with their meanings; balance column widths for the content |
| Callouts and quotes | Separate important boundaries or quoted material without replacing the main explanation |
| Links, images, media and dividers | Provide the relevant destination or visual where it supports a task |
| Undo, Redo and Remove format | Recover an edit or remove unwanted pasted styling |
| Source | Edit 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
- Select Save draft while the article is being prepared. Confirm the saved article is marked Unpublished draft.
- 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.
- 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.
- 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 check | Expected result or evidence |
|---|---|
| The article is reopened after saving | The complete text and selected metadata match the intended version |
| A permitted reader opens the published article | The layout, links, FAQs and navigation support the task |
| A linked file or article is opened | The destination is correct and available to the intended reader |
| A draft is retained for editorial work | It remains unpublished rather than appearing as current guidance |
| An existing article is updated | Its established URL continues to serve the corrected content |
Troubleshooting
| Problem | What to check |
|---|---|
| The content looks different after paste | Use Undo or Remove format as appropriate, inspect Source if needed and verify the complete formatted result before saving |
| A linked article gives an access error | Check its publication state and Roles; the Article picker can include drafts |
| A link reaches a missing page | Check whether the target was deleted and update the source link to the current authoritative destination |
| The article appears under an unexpected Topic | Edit the article, select its intended Topic explicitly and save the correct state |
| A draft seems absent from reader search | Drafts are editorial material; published, eligible content supplies reader results |
FAQ
-
Does selecting an article in the Link dialog make it available to readers?
No. The picker can include drafts, and a link does not override the destination’s audience restrictions. Verify the target is published and available to the intended reader.
-
Should I create a new article when an existing process changes?
Usually update the existing authoritative article so its URL remains useful. Create a new article when it serves a distinct purpose, and review incoming links before retiring an old destination.
-
Is the editor’s Source mode for Markdown?
No. Source mode edits HTML. Return to the formatted view and inspect the full result before saving, because the editor can sanitize or normalize pasted content.
-
Are uploaded article files governed like Resource Library documents?
Do not assume the same model. Article attachments support the article’s explanation; the Resource Library is a separate managed document service with its own access relationships. Use that service for the controlled document collection it is designed to maintain.