Write articles

Use the article editor: text, images, videos, tables, callouts and more.

Frequently asked questions

  • When does an article show a table of contents?

    When the article has headings and your theme's Article page includes the Table of contents component. Readers then see an On this page list beside the article and can jump to any section.

    Screen recording of a published article. On this page jumps to any section. Export prints the article or adds it to an AI assistant. Readers tell you if it helped.
    The On this page list follows the reader down the article.

    The list is built from the article's headings, starting at Heading 2. The article title isn't included, and an article without headings shows no list. Use Heading 2 for your main sections and Heading 3 for the parts inside them.

    Compass, the default theme, includes the component. To add it, remove it or change it:

    1. Open the Template editor, go to Pages and pick the Article page.

    2. The component lives in the Sidebar or Utility region. Add it there with Add component, or click it to edit it.

    3. In Heading levels, choose how deep the list goes, from Heading 2 only down to Heading 5. Sticky keeps it in view while readers scroll.

    4. Click Publish.

    Related articles

    Read more

  • Preview an article before you publish

    Save the article, then click the eye icon (Preview article) in the top bar. The preview opens in a new tab and shows the article on your help center, with your design, the way readers will see it.

    Screen recording. Click the eye icon to preview the draft. It opens in a new tab. You see it as readers will. Only your team can open this preview.
    Preview a draft before anyone else can see it.
    • Save first. The eye icon is grayed out until the article has been saved once. The preview shows the last saved version, so click Save draft before you preview your latest edits.

    • Published articles: your edits are saved when you click Update, which also publishes them. Until then, the preview shows the live version. On help centers with staged changes, click Preview in the staged changes banner to see your edits before they go live.

    • Who can open it: only teammates who can edit articles (Owners, Admins and Editors). Someone who isn't signed in is asked to sign in first, and anyone else gets a page-not-found page for an unpublished article.

    You'll also find Preview article in the menu next to Publish.

    Related articles

    Read more

Articles

Still stuck?

Our team answers in a few hours.

Ask us