Resolving Heading Structure Issues

What is heading structure?

Headings organize the content of a webpage into sections, making it easier for visitors to scan the page and understand how information is organized.

Assistive technologies also rely on headings to help users navigate quickly between sections of a page.

DubBot reports heading structure issues when headings are missing, out of order, or used incorrectly.

Common heading issues

DubBot may identify issues such as:

• Skipped heading levels (for example, an H2 followed immediately by an H4).
• Missing headings.
• Empty headings.
• Multiple H1 headings on a page.
• Headings used only for visual formatting.

Using headings correctly

Headings should create a logical outline of your page.

For example:

H1  Page Title
 ├─ H2  Section
 │   ├─ H3  Subsection
 │   └─ H3  Subsection
 └─ H2  Section
     └─ H3  Subsection

Avoid skipping levels simply to make text appear larger or smaller.

For example:

❌ H2 → H4

✔ H2 → H3

Fixing heading issues in Cascade CMS

1. Open the affected page in Cascade CMS.
2. Locate the heading identified by DubBot.
3. Update the heading level to match the page’s content hierarchy.
4. Remove any empty headings.
5. Publish the updated page.

Fixing heading issues in WordPress

1. Edit the affected page.
2. Select the heading block.
3. Choose the appropriate heading level.
4. Update the page.
5. Verify the published page.

Best Practices

• Every page should have a single primary heading (H1).
• Use headings to organize content, not to change text size.
• Keep heading levels in logical order.
• Use CSS or formatting options for appearance instead of choosing a heading level for visual effect.
• Keep headings concise and descriptive.

Verify the correction

After publishing:

1. Review the page to ensure headings appear in a logical order.
2. Confirm each section begins with an appropriate heading.
3. Wait for DubBot’s next crawl to verify the issue has been resolved.

When to contact Web Services

If the reported heading is generated by a website template, navigation, or other shared component that cannot be edited within your CMS, submit a Web Services support ticket.