Knowledge: Use Headings for Proper Article Structure

Use headings to identify the topics and subtopics of your article. Headings have several functions:

  • Provide a quick overview of an article.
  • Act as visual dividers and make the content appear less dense.
  • Help mark the way and allow users to decide whether to read the content or not.
  • Allow those people using adaptive technologies, such as a screen reader, to jump from section to section to find the content they need.

Using Headings

There are 6 headings available in TDX, each with their own style. In HTML code, heading styles are referenced as h#, where # sign is the number of the heading. 

  • Heading 1 (h1) Article Subject - in TDX, the Subject field is automatically formatted as an H1 heading. For accessibility, there should be only one h1 per webpage so do not use an h1 heading anywhere in the content area.
    • The Subject serves as the summary heading for an article. Do not repeat it in the content area.
  • Heading 2 (h2) Major topics - format all major topics with the h2 heading
  • Heading 3 (h3) Subtopics - use to format all subtopics
  • Heading 4 (h4) Sub-subtopics - use as needed
  • Headings 5 and 6 (h5 and h6) - Try writing your content to avoid using these headings but they are available if needed
    Sample of published ServiceNow knowledge article with arrows pointing to and labeling the H1, H2, and H3 text.

Headings should not have a colon at the end.

Note: Unless an article is short, if you have 2 or more Headings Make a Table of Contents or Other Jump-to Links.

Formatting Headings

To format a heading in the TDX editor:

  1. Click somewhere in the text you want to make a heading.
  2. Choose a heading style from the paragraph style menu immediately to the right of the Styles menu on the editing toolbar. The heading style is applied immediately.