Title: Accordion Item
Published: June 7, 2026
Last modified: October 14, 2026

---

# Accordion Item

## In this article

 * [Block Relationships](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#block-relationships)
 * [Attributes](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#attributes)
 * [Supports](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#supports)
 * [Context](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#context)
 * [Block Markup](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#block-markup)
 * [Source](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#source)

 Wraps the heading and panel in one unit.

 * **Name:** `core/accordion-item`
 * **Category:** [design](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/)
 * **API Version:** [3](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-api-versions/)
 * **Block Type:** [Hybrid](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/)(
   static save + server enhancements)

## 󠀁[Block Relationships](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#block-relationships)󠁿

**[Parent](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/#parent)
blocks (direct):**
 – [`core/accordion`](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion/)

**[Allowed](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/#allowed-blocks)
inner blocks:**
 – [`core/accordion-heading`](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-heading/)–
[`core/accordion-panel`](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-panel/)

## 󠀁[Attributes](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#attributes)󠁿

_Defined via the [`attributes`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/)
property in block.json._

  |  Attribute |  [Type](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#type-validation) |  [Default](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#default-value) |  Description |  
   |  `openByDefault` |  `boolean` |  `false` |  — |

## 󠀁[Supports](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#supports)󠁿

_Defined via the [`supports`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/)
property in block.json._

 * [`html`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#html):`
   false`
 * [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#background):
    - `gradient`: `true`
 * [`color`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color):
    - [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-background):`
      true`
    - [`gradients`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-gradients):`
      true`
    - [`link`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-link):`
      true`
    - [`heading`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-heading):`
      true`
    - [`button`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-button):`
      true`
 * [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):`
   true`
 * [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
    - `margin`: `["top","bottom"]`
    - `padding`: `true`
    - `blockGap`: `true`
 * [`shadow`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#shadow):`
   true`
 * [`layout`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout):
    - [`allowEditing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#layout-allowediting):`
      false`
 * [`typography`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography):
    - [`fontSize`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-fontsize):`
      true`
    - [`lineHeight`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#typography-lineheight):`
      true`
 * [`contentRole`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#contentrole):`
   true`

## 󠀁[Context](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#context)󠁿

_Defined via the [`usesContext` and `providesContext`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-context/)
properties in block.json._

**Provides context:**

 * `core/accordion-open-by-default`  attribute `openByDefault`

## 󠀁[Block Markup](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#block-markup)󠁿

This is a [**hybrid block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/).
It saves static markup that the server may enhance during rendering.

    ```html
    <!-- wp:accordion-item -->
    <div class="wp-block-accordion-item">
        <!-- wp:accordion-heading -->
        <h3 class="wp-block-accordion-heading has-icon has-icon-right">
            <button type="button" class="wp-block-accordion-heading__toggle"><span class="wp-block-accordion-heading__toggle-title">Accordion Title</span><span class="wp-block-accordion-heading__toggle-icon" aria-hidden="true">+</span></button>
        </h3>
        <!-- /wp:accordion-heading -->
        <!-- wp:accordion-panel -->
        <div role="region" class="wp-block-accordion-panel">
            <!-- wp:paragraph -->
            <p>Accordion  Panel Content</p>
            <!-- /wp:paragraph -->
        </div>
        <!-- /wp:accordion-panel -->
    </div>
    <!-- /wp:accordion-item -->
    ```

## 󠀁[Source](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-item/?output_format=md#source)󠁿

 * [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/accordion-item/block.json)(
   [reference](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-metadata/))
 * [Source directory](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/accordion-item/)—
   browse the `edit` and `save` source files, `index.php`, and more.

First published

June 7, 2026

Last updated

October 14, 2026

Edit article

[ Improve it on GitHub: Accordion Item ](https://github.com/WordPress/gutenberg/edit/trunk/packages/block-library/src/accordion-item/README.md)

[  Previous: Accordion Heading](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-heading/)

[  Next: Accordion Panel](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-accordion-panel/)