How to Fix Missing or Confusing Headings

What the flag means

Crystal Ball flags a missing H1, multiple H1s, no H2 sections, or heading levels that appear to skip around. These are review prompts rather than automatic failures: a short page may not need an H2, and multiple H1s can be valid when the document structure remains clear.

Headings help people, assistive technology, and search systems understand how the page is organized. Review whether the main topic is obvious, major sections have descriptive labels, and heading levels reflect real hierarchy rather than visual size alone.

Common causes

These flags often come from visual builders, shared templates, logos marked as H1s, repeated hero modules, or text styled to look like a heading without semantic heading markup. Inspect the rendered page and source before changing a template-wide pattern.

How to fix it

Confirm the warning first and make a backup before editing the live site. If the change involves templates, code, DNS, redirects, or server settings, switch to Intermediate or ask for help before proceeding.

• Custom HTML/static: Use one clear <h1>, then organize major sections with <h2> and subsections with <h3>. MDN's heading elements reference is a good technical guide.
• WordPress: Use the Heading block and choose the correct level. Most pages should start body sections at H2 because the page title is usually the H1. See the WordPress Heading block.
• Shopify: Edit page, product, collection, or blog content in the rich text editor. Shopify's rich text editor lets you format content and edit HTML when needed. See Shopify rich text editor.
• Wix: Select the text element and adjust its heading tag rather than only changing its visual style. Wix documents managing page heading tags.
• Webflow: Use actual Heading elements and set the correct H1-H6 level. Webflow explains that headings guide people and search engines. See Webflow Heading.