Skip to main content
sus.botdocs
  • SEO
  • AI
  • QA
  • Privacy
  • Accessibility
  • Security
  1. Docs
  2. Accessibility
  3. What looks like structure is not marked up as structure
  4. Text that looks like a heading without heading markup, and heading markup on long text

Accessibility finding

Text that looks like a heading without heading markup, and heading markup on long text

Accessibility Warning Severity: Medium

Part of the audit What looks like structure is not marked up as structure. Finding id: accessibility.visualVsSemanticStructure.

What it costs you

Screen reader users move through a page by its list of headings. A whole paragraph marked as a heading fills that list with noise and is read out in full each time.

What to do

Worth checking by eye. If the text is a paragraph, mark it as one and give it its size with CSS.

What it checks

  • Text styled as heading without heading markup
  • Heading markup used only for styling

How to fix it

Use heading elements for headings and CSS for size

    How to check: Recrawl, then list the page's headings with a screen reader or browser tool: the list reads as a table of contents.

    Thresholds

    Thresholds for Text that looks like a heading without heading markup, and heading markup on long text
    NameDefaultMeaning
    max_heading_length150A heading longer than this many characters is queued as probably used for its looks.

    How to verify by hand

    A person.

    What this relies on

    The visual design shows the intended structure.

    • All audits
    • About sus.bot
    • Open the app
    • Contact support