Slowly
The builderBlocks

Accordion

Collapsible rows, the building block of FAQs and any list of labels that open to more.

An accordion is a row that stays closed until clicked, then opens to reveal its content. It is what FAQs are built from, and anywhere a list of labels should each open to more. For a line or two, use a paragraph instead.

Made of three blocks, added together:

  • Accordion wraps one row and controls how it opens.
  • Accordion header is the visible label and the click target.
  • Accordion content is what shows and hides.

The header starts with a heading, the content with a paragraph, and both are ordinary blocks: the header can hold an icon and heading, the content can hold images, columns, or a query. Click a header in the editor to open its row.

Adding one

  1. Select the section or container to hold it.
  2. Open the inserter, search "accordion".
  3. Pick the accordion block.

For a full FAQ, repeat the accordion in one container or use the accordions block. Inside a query or repeater, one accordion repeats per post or product.

Settings

In the accordion's own panel. Appearance lives in the shared design panel.

SettingWhat it doesReach for it when
Open by defaultRow starts open instead of closedThe first item in a list, or a lone accordion
GroupShared group name, one open at a time; opening one closes the restThe classic FAQ behaviour
TransitionLength of the open/close animation, or off so the row snapsOff is kinder to reduce-motion

Styling

Same design panel as every block: spacing, type, colour, borders, effects, each per breakpoint. The one accordion-specific point is that the header and content are separate blocks, so style them separately to control the closed and open states.

Accessibility

  • Write headers that name what is behind them, so anyone scanning or using a screen reader can choose without opening first.
  • Keep a real heading in the header, not text styled to look like one.

On this page