URL: /rules/content/heading-hierarchy

---
title: "Heading Hierarchy"
description: "Validates heading structure and hierarchy"
---

Validates heading structure and hierarchy

| | |
|---|---|
| **Rule ID** | `content/heading-hierarchy` |
| **Category** | [Content](/rules/content) |
| **Scope** | Per-page |
| **Severity** | warning |
| **Weight** | 5/10 |

## Solution

Proper heading structure (H1 → H2 → H3) helps users and search engines understand your content organization. Skipping levels (H1 → H3) creates confusion. Use headings in sequential order without skipping levels. Each section should use the next heading level down. Think of headings as an outline—they should make sense when read alone. Avoid empty headings or using headings purely for styling.

## Enable / Disable

### Disable this rule

```toml squirrel.toml
[rules]
disable = ["content/heading-hierarchy"]
```

### Disable all Content rules

```toml squirrel.toml
[rules]
disable = ["content/*"]
```

### Enable only this rule

```toml squirrel.toml
[rules]
enable = ["content/heading-hierarchy"]
disable = ["*"]
```