<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/AccessibilityHeadingLevel",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "SwiftUI"
    ],
    "preciseIdentifier" : "s:7SwiftUI25AccessibilityHeadingLevelO"
  },
  "title" : "AccessibilityHeadingLevel"
}
-->

# AccessibilityHeadingLevel

The hierarchy of a heading in relation to other headings.

```
@frozen enum AccessibilityHeadingLevel
```

## Overview

Assistive technologies can use this to improve a user’s navigation
through multiple headings. When users navigate through top level
headings they expect the content for each heading to be unrelated.

For example, you can categorize a list of available products into sections,
like Fruits and Vegetables. With only top level headings, this list requires no
heading hierarchy, and you use the [`AccessibilityHeadingLevel.unspecified`](/documentation/SwiftUI/AccessibilityHeadingLevel/unspecified) heading level. On the other hand, if sections
contain subsections, like if the Fruits section has subsections for varieties of Apples,
Pears, and so on, you apply the [`AccessibilityHeadingLevel.h1`](/documentation/SwiftUI/AccessibilityHeadingLevel/h1) level to Fruits and Vegetables, and the [`AccessibilityHeadingLevel.h2`](/documentation/SwiftUI/AccessibilityHeadingLevel/h2)
level to Apples and Pears.

Except for [`AccessibilityHeadingLevel.h1`](/documentation/SwiftUI/AccessibilityHeadingLevel/h1), be sure to precede all leveled headings by another heading with a level
that’s one less.

## Topics

### Getting the heading level

[`AccessibilityHeadingLevel.h1`](/documentation/SwiftUI/AccessibilityHeadingLevel/h1)

Level 1 heading.

[`AccessibilityHeadingLevel.h2`](/documentation/SwiftUI/AccessibilityHeadingLevel/h2)

Level 2 heading.

[`AccessibilityHeadingLevel.h3`](/documentation/SwiftUI/AccessibilityHeadingLevel/h3)

Level 3 heading.

[`AccessibilityHeadingLevel.h4`](/documentation/SwiftUI/AccessibilityHeadingLevel/h4)

Level 4 heading.

[`AccessibilityHeadingLevel.h5`](/documentation/SwiftUI/AccessibilityHeadingLevel/h5)

Level 5 heading.

[`AccessibilityHeadingLevel.h6`](/documentation/SwiftUI/AccessibilityHeadingLevel/h6)

Level 6 heading.

[`AccessibilityHeadingLevel.unspecified`](/documentation/SwiftUI/AccessibilityHeadingLevel/unspecified)

A heading without a hierarchy.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)