---
title: HeadingGroup
description: |-
  The HeadingGroup component controls the heading level hierarchy for any [Heading](/docs/api/admin-extensions/2026-01/ui-components/typography-and-content/heading) components nested inside it. Use HeadingGroup to build a correct document outline without manually tracking heading levels. Each layer of nesting automatically increments the level by one (h1 becomes h2, h2 becomes h3, and so on).

  HeadingGroup doesn't accept any props and doesn't render visible UI. It's a purely structural wrapper. For a visible content grouping that also increments heading levels, use [Section](/docs/api/admin-extensions/2026-01/ui-components/layout-and-structure/section) instead.
api_version: 2026-01
api_name: admin-extensions
source_url:
  html: https://shopify.dev/docs/api/admin-extensions/latest/components/titles-and-text/headinggroup
  md: https://shopify.dev/docs/api/admin-extensions/latest/components/titles-and-text/headinggroup.md
---

Heading​Group

Not supported in this version.