Docs
← Back to site

FAQ Accordion Block

1 min readUpdated October 29, 2026

Expandable question-and-answer pairs, built on native HTML <details> and <summary> elements rather than custom JavaScript, so the expand/collapse behavior works even if a script elsewhere on the page fails to load.

An FAQ Accordion block with the first question open.

Adding the block#

Add an FAQ Accordion block from the block inserter. Each item has:

  • Question
  • Answer

Example:

Question 1
Answer 1
Question 2
Answer 2
Question 3
Answer

Managing items#

Use Add item to add another question-and-answer pair. Each item has Move up, Move down, and a remove button, the same up/down-arrow reordering pattern as the Numbered Steps block, not drag-and-drop. At least one item always remains.

How it behaves for readers#

Each question is collapsed by default. Clicking a question expands its answer; clicking again collapses it. Multiple items can be open at once, since each <details> element is independent, opening one doesn’t close another.

The expand icon uses your site’s accent color and flips to a minus sign once that item is open.

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only