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 = ["*"]
```