---
title: Section
description: >-
  The section component groups related content into clearly-defined thematic
  areas with consistent styling and structure. Use section to organize page
  content into logical blocks, each with its own heading and visual container.


  Sections automatically adapt their styling based on nesting depth and adjust
  heading levels to maintain meaningful, accessible page hierarchies. For simple
  visual separation without headings, use
  [divider](/docs/api/checkout-ui-extensions/2026-01/polaris-web-components/layout-and-structure/divider).
api_version: 2026-01
api_name: checkout-ui-extensions
source_url:
  html: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/latest/polaris-web-components/layout-and-structure/section
  md: >-
    https://shopify.dev/docs/api/checkout-ui-extensions/latest/polaris-web-components/layout-and-structure/section.md
---

# Section

The section component groups related content into clearly-defined thematic areas with consistent styling and structure. Use section to organize page content into logical blocks, each with its own heading and visual container.

Sections automatically adapt their styling based on nesting depth and adjust heading levels to maintain meaningful, accessible page hierarchies. For simple visual separation without headings, use [divider](https://shopify.dev/docs/api/checkout-ui-extensions/2026-01/polaris-web-components/layout-and-structure/divider).

## Properties

* **accessibilityLabel**

  **string**

  A label used to describe the section that will be announced by assistive technologies.

  When no `heading` property is provided or included as a children of the Section, you **must** provide an `accessibilityLabel` to describe the Section. This is important as it allows assistive technologies to provide the right context to users.

* **heading**

  **string**

  A title that describes the content of the section.

* **id**

  **string**

  A unique identifier for the element.

Examples

## Preview

![](https://cdn.shopify.com/shopifycloud/shopify-dev/development/assets/assets/images/templated-apis-screenshots/checkout-ui-extensions/2025-10/section-default-BliTcwxw.png)

### Examples

* #### Code

  ##### Default

  ```html
  <s-section heading="Rewards">
    <s-paragraph>
      Earn 10 points for every $1 spent. Redeem 100 points for $10 off your next
      purchase.
    </s-paragraph>
  </s-section>
  ```

## Useful for

* Organizing your page in a logical structure based on nesting levels.
* Creating consistency across pages.

## Considerations

* When adding headings inside sections they automatically use a specific style, which helps keep the content organized and clear.