Structure headings as H1, H2 and H3

Headings describe document structure for readers, assistive technology and extraction tools. Use one H1, H2 for main sections and H3 for subsections without skipping levels. Style with classes rather than heading tags, and make each heading a specific statement instead of a generic label.

mediumIn codeimpact effort

Why this matters

Use headings to describe sections, then style them with CSS.

Get the full breakdown

The extended brief explains when this works, when it does not, and the trade-offs. Join the waitlist and it unlocks for every tip when sign-in opens; MCP access is the paid part.

Join the waitlist

Before you start

  • Access to content templates and the CMS editor

How to apply it

  1. Audit the outline General best practice

    Extract headings in document order for five key pages. Check for one H1, sequential levels and headings that describe the section rather than repeat the title.

    Check: Each audited page has one H1 and no skipped heading levels.

  2. Rewrite generic headings General best practice

    Replace labels such as Overview or More info with statements that name the section's subject. Keep them under about 60 characters.

    Check: Each rewritten heading names the section subject without the words overview or more info.

  3. Replace style-based heading usage General best practice

    Convert decorative headings in cards and footers to styled paragraphs, and move font-size rules from h1-h6 selectors to utility classes.

    Check: No heading element appears inside a card or footer component.

Get the prompt for your agent

A ready-to-paste prompt for your agent that implements this tip and verifies the result in your repo.

Join the waitlist

Source: seo-mcp playbook · curated entry · report an error

Framework notes

nextjs-app

Render article headings from MDX or CMS data with explicit level props so an inserted H3 cannot skip a level under an H2.

wordpress

Restrict the block editor heading levels in the theme, and check that page builders do not output heading tags for design elements.

Official references

Let your agent apply this + 161 more tips.

Pre-order — $19