Menu

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
BlockFits these page types
Post listPage, Blog home, Docs home
Heading, Code block, Callout, Table, TabsEvery 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.

Post list

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.

Post list
OptionWhat it doesChoices
LayoutHow 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 postsHow many posts show (per page, when split into pages).3, 6, 9 (default), 12
SourceWhich blog the posts come from.All blogs, or one blog
TagShows only posts with this tag.Any tag, or one tag
CategoryShows only posts in this category.Any category, or one category
OrderThe order of the posts.Newest first (default), Oldest first, Title A to Z
Split into pagesAdds numbered pages so visitors can go back through every post.No (default), Yes
Image, Date, Excerpt, TagsUnder Card shows: which parts each card shows.Show (default), Hide
Anchor, Vertical padding, BackgroundSee 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.

The Post list block, shown with sample content.

Heading

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.

Heading
OptionWhat it doesChoices
LevelLevel 2 for a main part, Level 3 for a part inside it.Level 2 (default), Level 3
TextThe heading, up to 120 characters. Required.
Anchor, Vertical paddingSee 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.

The Heading block, shown with sample content.

Code block

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.

Code block
OptionWhat it doesChoices
LanguageA short label above the code, such as bash or json, up to 24 characters. Leave it empty for no label.
CodeThe text to show, exactly as readers should copy it, up to 10,000 characters. Required.
Anchor, Vertical paddingSee Blocks reference.

On the published page, Copy copies the whole code and changes to Copied. Long lines scroll sideways rather than wrap.

Images: none.

The Code block block, shown with sample content.

Callout

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.

Callout
OptionWhat it doesChoices
ToneThe kind of remark, which sets the callout's colour and icon.Note (default), Tip, Warning, Danger
TitleA short title in bold, up to 60 characters. Leave it empty for no title.
TextThe remark, in rich text: bold, italic, lists and links.
Anchor, Vertical paddingSee Blocks reference.

Images: none.

The Callout block, shown with sample content.

Table

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.

Table
OptionWhat it doesChoices
Table name for screen readersA name for the table that screen readers announce. It does not show on the page. Up to 80 characters.
Columns2 to 6 columns, each with a Header of up to 40 characters.
Rows1 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 paddingSee Blocks reference.

On a narrow screen, a wide table scrolls sideways.

Images: none.

The Table block, shown with sample content.

Tabs

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.

Tabs
OptionWhat it doesChoices
Tabs2 to 5 tabs, each with a Label (up to 32 characters) and a Panel in rich text.
Anchor, Vertical paddingSee 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.

The Tabs block, shown with sample content.