Blog and docs blocks
This page helps you list your blog posts and structure help pages and long posts.
These blocks (the sections of a page) sit in the Blog and Docs groups of Add blocks.
| Block | Fits these page types |
|---|---|
| Post list | Page, Blog home, Docs home |
| Heading, Code block, Callout, Table, Tabs | Every type: Page, Blog home, Post, Docs home, Doc page |
The docs blocks keep to the width of body text and have Anchor and Vertical padding but no Background; see Blocks reference.
Lists the site's published posts as cards with a cover, a date, a title, an excerpt and tags, from every blog or from one, optionally narrowed to one tag or one category. Choose it to show the latest posts on a home or landing page, or a blog's posts on its blog home. You never type the posts: they come from your published blogs.
| Option | What it does | Choices |
|---|---|---|
| Layout | How the posts are arranged. Grid shows cards in columns. List shows one post per row with its cover beside the text. Featured and list shows the first post large, with the others listed beside it. | Grid (default), List, Featured and list |
| Number of posts | How many posts show (per page, when split into pages). | 3, 6, 9 (default), 12 |
| Source | Which blog the posts come from. | All blogs, or one blog |
| Tag | Shows only posts with this tag. | Any tag, or one tag |
| Category | Shows only posts in this category. | Any category, or one category |
| Order | The order of the posts. | Newest first (default), Oldest first, Title A to Z |
| Split into pages | Adds numbered pages so visitors can go back through every post. | No (default), Yes |
| Image, Date, Excerpt, Tags | Under Card shows: which parts each card shows. | Show (default), Hide |
| Anchor, Vertical padding, Background | See Blocks reference. |
A post's cover and excerpt are set in its page settings (Cover, Excerpt), not in the block.
Split into pages works only on the first Post list of a blog home that lists that same blog. Anywhere else the list shows its first posts, and when Source is one blog, a View all button under the cards leads to that blog.
When there are no published posts to show, the block shows an empty box in the editor and nothing on the published site.
Images: each cover is cropped to 4:3 in Grid and List. In Featured and list, the first post's cover is 16:9 and the others are 4:3.

A level 2 or level 3 heading that readers can link to. On a doc page, every Heading appears in On this page. Choose it to split a docs page or a long post into parts; never for the page title, which comes from the page itself.
| Option | What it does | Choices |
|---|---|---|
| Level | Level 2 for a main part, Level 3 for a part inside it. | Level 2 (default), Level 3 |
| Text | The heading, up to 120 characters. Required. | |
| Anchor, Vertical padding | See Blocks reference. |
When readers point at a heading, a link icon appears beside it; it gives an address that opens the page at that heading. Give the heading an Anchor, such as install, to make that address readable.
Images: none.

Shows commands, a configuration sample or a request as monospace text with a Copy button. Choose it when readers need to copy exact text, such as a command or a DNS record; never for ordinary sentences or a single word inside a sentence.
| Option | What it does | Choices |
|---|---|---|
| Language | A short label above the code, such as bash or json, up to 24 characters. Leave it empty for no label. | |
| Code | The text to show, exactly as readers should copy it, up to 10,000 characters. Required. | |
| Anchor, Vertical padding | See Blocks reference. |
On the published page, Copy copies the whole code and changes to Copied. Long lines scroll sideways rather than wrap.
Images: none.

Sets a short remark apart from the text around it as a note, a tip, a warning or a danger. Choose it for a side remark, a shortcut, a step with a consequence or an action that cannot be undone; one remark per callout, never the main text of a step.
| Option | What it does | Choices |
|---|---|---|
| Tone | The kind of remark, which sets the callout's colour and icon. | Note (default), Tip, Warning, Danger |
| Title | A short title in bold, up to 60 characters. Leave it empty for no title. | |
| Text | The remark, in rich text: bold, italic, lists and links. | |
| Anchor, Vertical padding | See Blocks reference. |
Images: none.

Lays out short facts in two to six columns under a header row, such as settings, options or values. Choose it for reference facts readers scan row by row; never for plans or for paragraphs.
| Option | What it does | Choices |
|---|---|---|
| Table name for screen readers | A name for the table that screen readers announce. It does not show on the page. Up to 80 characters. | |
| Columns | 2 to 6 columns, each with a Header of up to 40 characters. | |
| Rows | 1 to 50 rows. Each row has First column to Sixth column; fill the cells for the columns you have, up to 200 characters each. | |
| Anchor, Vertical padding | See Blocks reference. |
On a narrow screen, a wide table scrolls sideways.
Images: none.

Offers two to five alternatives a reader picks one of, such as the steps for each registrar or each device, each a label over a short panel. Choose it when readers need only one of several parallel variants; never for content everyone must read, or for comparing values side by side.
| Option | What it does | Choices |
|---|---|---|
| Tabs | 2 to 5 tabs, each with a Label (up to 32 characters) and a Panel in rich text. | |
| Anchor, Vertical padding | See Blocks reference. |
On the published page, readers see a row of tabs and choose one; the arrow keys move between tabs. Without JavaScript, every panel shows one under the other under its label, so nothing is hidden.
Images: none.

