Skip to content

FAQ Accordion with Details Blocks

An FAQ accordion with six expandable questions next to a heading and contact button, a frequently asked questions section built from Gutenberg Details blocks.

Also known as: faq section, gutenberg faq block, frequently asked questions accordion, collapsible faq without plugin, questions and answers section

FAQ Accordion with Details Blocks live demo

Open in new tab

WordPress block markup

This FAQ accordion with Details blocks is a Gutenberg pattern that puts a heading, short intro and contact button next to six expandable questions. It gives you a frequently asked questions section, a collapsible FAQ without a plugin and a clean questions and answers layout, using only the core Details block.

How it works

A full-width Group with a white background and 112px vertical padding holds a Columns block split 38% / 62%. The left column has an indigo eyebrow, an h2 heading, a paragraph that points readers to support, and a single Button. The right column contains six Details blocks spaced 12px apart. Each Details block has a light gray background, 12px rounded corners and 22px by 28px padding; its summary is the question and a Paragraph inside holds the answer. The first item is open by default so visitors see what an answer looks like. Details uses the native HTML details and summary elements, so it opens and closes without JavaScript. On phones the columns stack and the questions follow the intro.

How to use it

  1. Copy the block markup.
  2. Paste it into an empty paragraph in the block editor.
  3. Replace the questions, answers and the button link with your own content.

Customization

  • Item background: select a Details block, Color > Background, #f3f4f6. Select all six with Shift-click to change them at once.
  • Question style: on the Details block, Typography > Size 17px and Appearance 600 set the question text; the answer Paragraph resets to 16px, weight 400 and Color > Text #4b5563.
  • Open by default: select a Details block and toggle "Open by default" in the block settings. It is enabled on the first question.
  • Accent color: the eyebrow uses Color > Text #4f46e5 and the button Color > Background #4f46e5. Change both for your brand.
  • Spacing between items: select the right Column, Dimensions > Block spacing, 12px.
  • Column widths: select a Column and change Width (38% and 62%).
  • More questions: duplicate a Details block (Ctrl+Shift+D) and edit the summary and answer.

Use cases

  • SaaS pricing and product pages: answer questions about plans, trials and security.
  • Online shops: cover shipping, returns and payment questions above the footer.
  • Service businesses: explain booking, cancellations and what is included.
  • Help centre landing pages: list the most common questions with a link to contact support.

Accessibility

Native details and summary elements are keyboard accessible: Tab moves between questions, Enter or Space toggles them, and screen readers announce the expanded state. The section has a single h2 heading. Dark text on #f3f4f6 and white on #4f46e5 meet WCAG AA contrast.

FAQ Accordion with Details Blocks at a glance

Framework
WordPress
Code
WordPress block markup (core blocks only)
JavaScript
Not needed
Dependencies
None, no plugin needed (WordPress 6.8+)
Layout
Responsive, works on mobile
Category
FAQ Sections
License
Free for personal and commercial use

Questions about this pattern

Can I use the FAQ Accordion with Details Blocks code for free?

Yes. You can copy or download the block markup and use it in personal and commercial projects, including client work. No sign-up is needed. Reselling it as part of a component library or template collection is not allowed; see the license.

How do I add it to my WordPress site?

Copy the block markup, open a page in the block editor, click into an empty paragraph and paste. WordPress turns it into regular blocks that you can edit like any other content. You can also paste it in the Code editor view (Options menu > Code editor).

Does it need a page builder or plugin?

No. The pattern is built only from core blocks such as Group, Columns, Heading, Image and Buttons, so it works without Elementor, Spectra, Kadence or any other plugin. Colors and spacing are set on the blocks themselves; headings and text use your theme's fonts.

Will it look the same in my theme?

The layout, colors and spacing come with the blocks, so they carry over. Fonts, link styles and the content width follow your theme, so small differences are normal. The live demo shows the pattern in the default Twenty Twenty-Five theme. It works best with block themes; in classic themes the block editor still renders it, with your theme's styles.

Does it work on mobile?

Yes. The layout adapts to small screens. Use the Mobile and Tablet buttons above the live demo to check it at phone and tablet width.

How to install

  1. Copy the block markup above.
  2. Open a page or post in the WordPress block editor, click into an empty paragraph and paste. The editor turns the markup into blocks.
  3. Replace the sample text and images. To reuse it, select the blocks and choose Create pattern from the block toolbar menu.

Uses only core WordPress blocks, so no plugin is needed. Tested with WordPress 6.8 and later. Fonts come from your theme; the live demo uses the default Twenty Twenty-Five theme. WebDevSnippets is not affiliated with or endorsed by the WordPress Foundation.

FAQ Accordion with Details Blocks – WordPress faq sections component screenshot
FAQ Accordion with Details Blocks · WordPress FAQ Sections

More FAQ Sections

Two-Column FAQ – Bootstrap 5 faq sections preview

Two-Column FAQ

Bootstrap 5 FAQ section with questions split into two accordion columns, plus/minus icons and a dark contact support prompt.

FAQ Accordion Section for Shopify – Shopify faq sections preview

FAQ Accordion Section for Shopify

Shopify FAQ section with a native details accordion, an intro column with contact button, and optional FAQPage structured data.

FAQ with Category Tabs – Bootstrap 5 faq sections preview

FAQ with Category Tabs

Bootstrap 5 FAQ section where category pills switch between separate accordion sets, with question counts and a support card.

FAQ with Live Search Filter – Tailwind CSS faq sections preview

FAQ with Live Search Filter

Tailwind CSS FAQ section with a live search box that filters questions as you type, highlights matches, adds topic chips and shows an empty state.

FAQ Accordion Section – Tailwind CSS faq sections preview

FAQ Accordion Section

Dark Tailwind CSS FAQ section with an accessible accordion, smooth expand animation, keyboard navigation and a support contact card.