Excerpt

---

• Attributes
• Supports
• Context
• Block Markup
• Source

---

Display the excerpt.

• Name: core/post-excerpt
• Category: theme
• API Version: 3
• Block Type: Dynamic (server-rendered)

Attributes

Defined via the attributes property in block.json.

Attribute	Type	Default	Description
moreText	string	—	Role: content
showMoreOnNewLine	boolean	true	—
excerptLength	number	55	—

Supports

Defined via the supports property in block.json.

• anchor: true
• html: false
• background:
  • backgroundImage: true
  • backgroundSize: true
  • gradient: true
• color:
  • gradients: true
  • link: true
• shadow: true
• spacing:
  • margin: true
  • padding: true
• dimensions:
  • minHeight: true
  • minWidth: true
• typography:
  • fontSize: true
  • lineHeight: true
  • textAlign: true
  • textColumns: true
• interactivity:
  • clientNavigation: true

Context

Defined via the usesContext and providesContext properties in block.json.

Uses context:

• postId
• postType
• queryId

Block Markup

This is a dynamic block. It is rendered on the server and does not save HTML in post content.

In post content, it is stored as a block comment:

<!-- wp:post-excerpt /-->

Source

• block.json (reference)
• Source directory — browse the edit and save source files, index.php, and more.