# Group Settings with `header`

Use `{"type":"header"}` entries to group related settings in the theme editor. Headers have no `id` — they render as visual separators with a label.

```json
{% schema %}
{
  "settings": [
    { "type": "header", "content": "Layout" },
    { "type": "range", "id": "height", "label": "Height", "min": 300, "max": 900, "step": 50, "unit": "px", "default": 600 },
    { "type": "range", "id": "height_mobile", "label": "Mobile height", "min": 200, "max": 700, "step": 50, "unit": "px", "default": 400 },

    { "type": "header", "content": "Slideshow" },
    { "type": "checkbox", "id": "autoplay", "label": "Autoplay", "default": true },
    { "type": "checkbox", "id": "show_arrows", "label": "Show arrows", "default": true },
    { "type": "checkbox", "id": "show_dots", "label": "Show pagination dots", "default": true }
  ]
}
{% endschema %}
```

Use headers whenever a section has more than ~4 settings. A schema that scrolls as a flat list is harder to scan than one with 2–3 grouped headers.

Headers accept `visible_if` too — hide an entire group when its feature is disabled.