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
Can I have multiple panels open at the same time?
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 settings include Open Icon and Close Icon reference fields. Upload SVG icons to the DAM and select them. You can also choose an icon animation style:

  • Rotate — the icon rotates 180 degrees on toggle
  • Swap — the open icon is replaced by the close icon
  • None — no animation, icons switch instantly
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, Arrow keys to move between headers
  • 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
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
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
How do I customize the open/close icons?

The accordion section settings include Open Icon and Close Icon reference fields. Upload SVG icons to the DAM and select them. You can also choose an icon animation style:

  • Rotate — the icon rotates 180 degrees on toggle
  • Swap — the open icon is replaced by the close icon
  • None — no animation, icons switch instantly
false
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, Arrow keys to move between headers

  • Focus management ensures logical tab order

The heading level is configurable (h2-h6) to maintain proper document outline.

false
accordion-usage

When to use

  • FAQ sections — questions as panel headers, answers as panel content. Use single-expand behavior.

  • Product specifications — group specs into categories (dimensions, compatibility, etc). Use multi-expand.

  • Legal/terms — break long legal text into manageable collapsible sections.

  • Progressive disclosure — any content where showing everything at once would overwhelm the user.

Key decisions

  • Behavior: accordion-single closes other panels when one opens (best for FAQs). accordion-multi allows multiple open panels (best for reference content).

  • Initial state: accordion-all-collapsed for compact pages, accordion-first-expanded to highlight the first item.

  • Nesting: Accordion is a section decorator — content blocks inside each panel can be text, images, or other blocks.

accordion-options

All authoring options

Section decorator

filter: accordion
model: accordion
name: display name

Behavior

classes_accordionBehavior: accordion-single | accordion-multi
classes_accordionExpanded: accordion-all-collapsed | accordion-first-expanded

Appearance

classes_accordionStyle: accordion-style-default | accordion-style-bordered | accordion-style-minimal

Analytics

trackInview: boolean
trackInviewMeta: text