Title: Separator
Published: June 7, 2026
Last modified: October 14, 2026

---

# Separator

## In this article

 * [Attributes](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#attributes)
 * [Supports](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#supports)
 * [Block Styles](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#block-styles)
 * [Block Markup](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#block-markup)
 * [Source](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#source)

 Create a break between ideas or sections with a horizontal separator.

 * **Name:** `core/separator`
 * **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:** [Static](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/)(
   saved in post content)
 * **Keywords:** `horizontal-line`, `hr`, `divider`

## 󠀁[Attributes](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?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 |  
   |  `opacity` |  `string` |  `"alpha-channel"` |  — |  
 |  `tagName` |  `string` |  `"hr"` |  [Enum](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-attributes/#enum-validation): `hr`, `div` |

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

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

 * [`anchor`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#anchor):`
   true`
 * [`align`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#align):`"
   center"`, `"wide"`, `"full"`
 * [`color`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color):
    - [`enableContrastChecker`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-enablecontrastchecker):`
      false`
    - [`gradients`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-gradients):`
      true`
    - [`background`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-background):`
      true`
    - [`text`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#color-text):`
      false`
 * [`spacing`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#spacing):
    - `margin`: `["top","bottom"]`
 * [`interactivity`](https://developer.wordpress.org/block-editor/reference-guides/block-api/block-supports/#interactivity):
    - `clientNavigation`: `true`

## 󠀁[Block Styles](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-separator/?output_format=md#block-styles)󠁿

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

  |  Style Name |  Label |  Default |  
   |  `default` |  Default |  Yes |  
 |  `wide` |  Wide Line |  No |  
 |  `dots` |  Dots |  No |

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

This is a [**static block**](https://developer.wordpress.org/block-editor/getting-started/fundamentals/static-dynamic-rendering/).
The markup is saved directly in the post content.

    ```html
    <!-- wp:separator -->
    <hr class="wp-block-separator has-alpha-channel-opacity"/>
    <!-- /wp:separator -->
    ```

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

 * [block.json](https://github.com/WordPress/gutenberg/tree/trunk/packages/block-library/src/separator/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/separator/)—
   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: Separator ](https://github.com/WordPress/gutenberg/edit/trunk/packages/block-library/src/separator/README.md)

[  Previous: Page Break](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-nextpage/)

[  Next: Spacer](https://developer.wordpress.org/block-editor/reference-guides/core-blocks/core-blocks-design/core-block-spacer/)