Paragraph
<p>Block of body text.This page shows you how to use the Paragraph block to add body text to your pages.
What it does
The Paragraph block adds a block of body text to your page. It is the most common block you will use — any time you need to write a sentence or a few lines of content, this is the one.
Like the native WordPress Paragraph block, it supports rich text formatting — <strong>, <em>, <code>, and other inline tags — with all the benefits of Unblock (custom selectors, attributes, dynamic data).
When to use
- Body text — Main content paragraphs
- Descriptions — Product or feature descriptions
- Introductions — Lead paragraphs and summaries
Dynamic content
Use expressions to display text from your data instead of typing it directly:
<p>{{ post.excerpt }}</p>
<p>Written by {{ post.author.name }} on {{ post.date|date('F j, Y') }}</p>
This is how you build templates — the paragraph pulls its content from the current post, user, or any other data source at render time.
Paragraph vs Text block
Paragraph wraps text in a <p> element. The Text block outputs text without any wrapping tag.
| Block | HTML | Use case |
|---|---|---|
| Paragraph | <p> | Block-level text with its own margins and spacing |
| Text | No wrapper | Bare text inside another element (e.g. a button label next to an SVG icon) |
If the text should stand on its own as a visible paragraph, use Paragraph. If it sits inside something else without needing a <p>, use Text.
HTML output
The Paragraph block outputs a standard <p> element:
<p>Your paragraph text goes here.</p>