Guides/Create content/Text/Accordion block

Accordion block

Last reviewed on December 3, 2025

Accordions display collapsible sections of content, each with a clickable header that expands or collapses the content within. In this guide, you will learn how to add, customize, and use the Accordion block on your WordPress.com site.

About accordions

Use accordions to organize information, reduce page length, and let visitors focus on the content that matters most to them. Accordions work well for organizing content that visitors may want to browse selectively. Here are some popular ways to use them:

  • Terms and policies: Present legal or policy information without overwhelming visitors.
  • FAQs: Group frequently asked questions with expandable answers.
  • Product details: Display specifications, sizing guides, or shipping information in collapsible sections.
  • Step-by-step instructions: Break down tutorials or guides into digestible steps.
  • Event schedules: Organize agendas or itineraries by time or session.
  • Team bios: Show brief introductions with expandable details about each team member.

Add the Accordion block

Follow these steps to add the Accordion block to a page or post:

  1. Visit your site’s dashboard.
  2. Navigate to Pages or Posts and click the page/post you want to add the accordion to.
  3. Click the + block inserter icon.
  4. Search for “Accordion block” and click it to add the block to the post or page:
The Accordion block is shown when searching for a block to add.

For more information, visit our detailed instructions on adding blocks.

Add content to the accordion

When you first add the Accordion block into your post or page, you will have the following sections:

  • Accordion item: Each collapsible section, containing a heading and panel.
    • Accordion heading: The clickable title that expands or collapses the content within.
    • Accordion panel: The content revealed when the header is clicked.
List View shows the accordion block, and the item, heading, and panel nested within.
The pieces of the Accordion block shown in List View

To complete your accordion:

  1. Add your title or heading text that you want visible at all times.
  2. Click inside the Accordion Panel area, or use List View to select it.
  3. Click the + block inserter to add blocks within the accordion panel area. You can add any type of content, including text, images, videos, and other blocks.
The accordion heading is shown. Underneath, there's a + icon button to add blocks to the accordion panel.
Click the + block inserter button or type the forward slash command to add a block inside the accordion.

Customize the accordion settings

The Accordion block includes settings that control how the accordion behaves. To access these settings, select the parent Accordion block using List View and open the block settings in the right sidebar.

If you do not have the sidebar on the right, click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:

An arrow pointing to the "Settings" icon in the top right of the WordPress Editor.

Inner blocks use content width

When “Inner blocks use content width” is switched on, blocks inside the Accordion block will adhere to these width settings:

  • Content: The width of the content area for blocks not set to wide or full-width.
  • Wide: The width of the content for blocks set to wide width.

Auto-close

When enabled, opening one accordion item automatically closes any other open items. This keeps your content tidy and ensures visitors focus on one section at a time.

Show icon

Toggle the expand/collapse icon (usually a “+” or arrow) that appears next to each accordion header. Disable this option for a cleaner, minimal look.

Icon position

Choose whether the icon appears on the left or right side of the accordion header.

Set an accordion item to open by default

You can set specific accordion items to display as expanded when the page loads. To do this, follow these steps:

  1. Use List View to select the Accordion Item block you want to open by default.
  2. In the block settings sidebar, enable the “Open by default” option.

Style your accordion

In the block settings sidebar, click on the Styles icon to access the design settings for the block. The Styles icon is in the shape of a circle, with half of the circle filled in:

An arrow pointing to the Styles icon in the block settings sidebar.

Available options include:

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!