accordion-hero
image
Accordion Block

ACCORDIONS: Expandable panels for progressive disclosure.

Section decorator that wraps content blocks into collapsible panels with toggle headers. Ideal for FAQs, specs, and long-form content.
inline-text-overlay
16.0
10.0
9.0
16.0

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)
what-is-accordion
What is the Accordion block and when should I use it?
The Accordion block is a section decorator that organizes content into collapsible panels. Each panel has a clickable header that toggles visibility of its content. Use it for FAQs, product specifications, legal terms, or any scenario where progressive disclosure helps reduce cognitive load.
true
multiple-panels
Can I have multiple panels open at the same time?

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.

true
custom-icons
How do I customize the open/close icons?

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)
true
accessibility
Is the accordion accessible for screen readers?

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.

true

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)
what-is-accordion-collapsed
What is the Accordion block and when should I use it?
The Accordion block is a section decorator that organizes content into collapsible panels. Each panel has a clickable header that toggles visibility of its content. Use it for FAQs, product specifications, legal terms, or any scenario where progressive disclosure helps reduce cognitive load.
false
multiple-panels-collapsed
Can I have multiple panels open at the same time?

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.

false
custom-icons-collapsed
How do I customize the open/close icons?

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)
false
accessibility-collapsed
Is the accordion accessible for screen readers?

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.

false

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.

An item with text only
The usual case: the header and a block of rich text.
false
An item with a nested accordion
The accordion below is loaded from /blocks/accordion/nested-accordion, the same page as in Example 3.
/content/rhea/blocks/accordion/nested-accordion
false
An item with a two-column layout
The columns below are loaded from /blocks/accordion/two-column-content.
/content/rhea/blocks/accordion/two-column-content
false
accordion-usage

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.
accordion-options

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