Example 1: ACCORDION COMPONENTS - Version 1.0
Expanded State By Default
Accordion Section
-
Appearance
-
Background Color - Primary
-
Style Variant - Default
-
Container Width - Default
-
Inner Content Width - Default
-
Content Horizontal Alignment - Left
-
Spacing - Default
-
-
Accordion Settings
-
Single Expand Mode - Off
-
Enable Expand All Button - Off
-
Animation style for icon transitions - Crossfade
-
Accordion Item Block
-
General
- Expanded by Default - On
-
Appearance
- Header Heading Level - H3 (default)
Yes. The accordion supports two behavior modes:
- Single expand — only one panel open at a time (ideal for FAQs where users browse one question at a time)
- Multi expand — multiple panels can be open simultaneously (ideal for reference content where users compare sections)
Configure this via the singleExpand toggle in the section settings.
The Accordion section has Open Icon and Close Icon fields: pick SVGs from the DAM. Icon Animation sets the transition between them:
- None: the icons switch instantly
- Crossfade: one icon fades into the other (Example 1)
- Rotation: the icon turns as it switches (Example 2)
- Scale + Fade: the icon shrinks out and grows in (Example 3)
Yes. The accordion follows WAI-ARIA Accordion Pattern guidelines:
- Headers use role="button" with aria-expanded state
- Content panels have role="region" with aria-labelledby
- Keyboard navigation supports Enter/Space to toggle, and the arrow keys, Home and End to move between the headers of the same accordion
- Focus management ensures logical tab order
The heading level is configurable (h2-h6) to maintain proper document outline.
Example 2: ACCORDION COMPONENTS - Version 1.0
Closed State By Default
Accordion Section
-
Appearance
-
Background Color - Tertiary
-
Style Variant - Default
-
Container Width - Default
-
Inner Content Width - Default
-
Content Horizontal Alignment - Left
-
Spacing - Default
-
-
Accordion Settings
-
Single Expand Mode - Off
-
Enable Expand All Button - Off
-
Animation style for icon transitions - Rotation
-
Accordion Item Block
-
General
- Expanded by Default - Off
-
Appearance
- Header Heading Level - H3 (default)
Yes. The accordion supports two behavior modes:
- Single expand — only one panel open at a time (ideal for FAQs where users browse one question at a time)
- Multi expand — multiple panels can be open simultaneously (ideal for reference content where users compare sections)
Configure this via the singleExpand toggle in the section settings.
The Accordion section has Open Icon and Close Icon fields: pick SVGs from the DAM. Icon Animation sets the transition between them:
- None: the icons switch instantly
- Crossfade: one icon fades into the other (Example 1)
- Rotation: the icon turns as it switches (Example 2)
- Scale + Fade: the icon shrinks out and grows in (Example 3)
Yes. The accordion follows WAI-ARIA Accordion Pattern guidelines:
-
Headers use role="button" with aria-expanded state
-
Content panels have role="region" with aria-labelledby
-
Keyboard navigation supports Enter/Space to toggle, and the arrow keys, Home and End to move between the headers of the same accordion
-
Focus management ensures logical tab order
The heading level is configurable (h2-h6) to maintain proper document outline.
Example 3: Accordion in a column
Not full width
The accordion below sits in a 67% column, beside a 33% column of notes. A Column cannot hold an Accordion section directly, so the column holds a Fragment block that points at /blocks/accordion/nested-accordion, a page holding the accordion.
Using fragments
How this is built
- Column, 67%: a Title and a Fragment block.
- Column, 33%: this text.
- The fragment page: one Accordion section, Bordered, with Single Expand Mode on.
The same fragment appears again in Example 4, nested inside an item.
Example 4: Nested accordion
Fragments inside items
Each item below has rich text, and two of them also set Accordion Item Content - Fragment. The fragment's sections render below the item's text, so an item can hold another accordion, or a layout such as columns.
Each accordion keeps its own settings. This outer accordion has Enable Expand All Button on: the button opens its three items, but not the items of the nested accordion, which keeps the Bordered style and Single Expand Mode set on its own fragment. The arrow keys, Home and End move between the headers of one accordion at a time.
When to use
- FAQs: questions as headers, answers as content. Turn on Single Expand Mode so readers take one answer at a time.
- Reference content, such as specifications: leave Single Expand Mode off so readers can compare items, and add the Expand All button.
- Long legal or terms text, split into sections a reader can scan.
- Progressive disclosure: anywhere showing everything at once would overwhelm.
Key decisions
- Placement. The Accordion is a section, so it sits between sections, never inside a Container or Column. To put one in a column, add a Fragment block to the column and point it at a page that holds the accordion (Example 3).
- Behavior. Single Expand Mode closes the open item when another opens. The Expand All button only appears when Single Expand Mode is off.
- Initial state. Set per item with Expanded by Default.
- Heading level. Set per item. Use the level below the heading that introduces the accordion: H3 under an H2, H4 under an H3.
- Nesting. An item holds rich text, not blocks. Its Content - Fragment field loads a page below that text, which can hold another accordion or a layout (Example 4). Each accordion keeps its own settings: the outer accordion's Single Expand Mode, Expand All button and keyboard navigation act only on its own items, and the nested accordion takes the style and behavior set on its own section.
All authoring options
Accordion (section)
Settings that apply to every item in the accordion.
| Tab | Field | Name | Values |
|---|---|---|---|
| Appearance | Background Color | style_background | Default, Inverse, Primary, Secondary, Tertiary, Primary Gradient, Secondary Gradient, Tertiary Gradient |
| Appearance | Style Variant | style_accordion-variant | Default, Bordered, Minimal |
| Appearance | Container Width | style_width | Default, Fullscreen, Small, Large |
| Appearance | Inner Content Width | style_content-width | Default, Fullscreen, Small, Large |
| Appearance | Content Horizontal Alignment | style_horizontal-alignment | Left, Center, Right |
| Appearance | Spacing | style_spacing | Default, None |
| Accordion Settings | Single Expand Mode | singleExpand | On / off |
| Accordion Settings | Enable Expand All Button | enableExpandAllCta | On / off |
| Accordion Settings | Expand All - CTA Style | expandAllCtaStyle | Link, Primary Filled, Primary Outlined, Secondary Filled, Secondary Outlined |
| Accordion Settings | Expand All - CTA Padding | expandAllCtaPadding | Default, Small, Large |
| Accordion Settings | Expand All - CTA Text Size | expandAllCtaTextSize | Default, Small, Large |
| Accordion Settings | Expand All - CTA Roundness | expandAllCtaRoundness | Default, None, Rounded, Curved |
| Accordion Settings | Expand All - Alignment | expandAllAlignment | Right, Left |
| Accordion Settings | Open Icon | openIcon | DAM asset |
| Accordion Settings | Close Icon | closeIcon | DAM asset |
| Accordion Settings | Icon Animation | style_iconAnimation | None, Crossfade, Rotation, Scale + Fade |
| Analytics | Track Inview | style_track-inview | On / off |
| Analytics | Track Click of Expand All CTA | style_track-expand-all | On / off |
| Analytics | Events/Analytics Meta | meta | Text |
Accordion Item (block)
Settings for one item. Add items inside an Accordion section; they accept no child blocks.
| Tab | Field | Name | Values |
|---|---|---|---|
| General | ID | accordionItemId | Text |
| General | Accordion Item Header | accordionItemHeader | Rich text |
| General | Accordion Item Content - Text | accordionItemContent | Rich text |
| General | Accordion Item Content - Fragment | accordionItemFragment | Page path |
| General | Expanded by Default | accordionItemExpanded | On / off |
| Appearance | Header Heading Level | classes_accordionItemHeadingLevel | H2, H3 (default), H4, H5, H6 |
| Analytics | Track Toggle | classes_track-toggle | On / off |
| Analytics | Track Content Link Click | classes_track-link-click | On / off |
| Analytics | Meta for Links in Accordion content | linkClickMeta | Text |
| Analytics | Events/Analytics Meta | meta | Text |