Start a blog
At the end of this guide your site has a blog home that lists your posts, a first published post, and its own pages for tags, categories and an RSS feed.
A blog is a Blog home with Post pages under it. The blog home's address is the blog's address, for example /news, and each post sits under it, for example /news/spring-service-checklist. A new blog home already holds a Post list block, one of the blocks (the sections of a page), which lists its posts and splits them into pages.
A blog home sits at the top level or under an ordinary page. It cannot be your site's home page, and it cannot sit inside another blog or docs area.
- Open Pages and choose New page.
- Under Type, choose Blog home.
- Type a Title, such as "News". Check the Slug, which becomes the address.
- Leave Parent on the top level, or choose another page.
- Choose Create page.

- Choose New page again and pick the Post type.
- If your site has more than one blog, choose it under Blog.
- Type the post's Title and choose Create page.
- Open the post in the editor and add your text.
If the site has no blog yet, the dialog says "Create a blog first" and offers New blog home.
A post offers only the blocks that fit an article: Text, Figure, Section, Spacer, Embed, and the docs blocks Heading, Code block, Callout, Table and Tabs. The post's title is its main heading, shown at the top of the page, so you do not add a hero.
- In the editor, click an empty part of the canvas so no block is selected. The right panel shows the page settings.
- Fill in the Post section (table below).
- Choose Save.

| Field | What it does |
|---|---|
| Date | "The date the post first went live. You can change it." Empty until the first publish |
| Excerpt | A short summary, up to 300 characters, shown on post list cards and in the feed |
| Cover | The post's image, shown in the post header and on cards |
| Author | Optional. Shown under the title |
| Tags, Categories | Pick from the ones on the Tags and categories screen. See Tags and categories |
| Previous, Next | Automatic links to the posts before and after by date. None hides the link. Or pick a post of the same blog |
On the published site, the post opens with a header (title, date, author, cover, categories and tags) and ends with its tags and links to the previous and next posts.
Publish the post as any page. See Publish changes. The first publish sets its Date.
Publishing a post also refreshes every page that lists or links to it, even pages you did not select. The publish dialog says so: "Publishing posts or doc pages also updates the pages that list or link to them".
Add a Post list block to any ordinary page, a blog home or a docs home, for example to show the latest three posts on your home page. It is not offered inside a post or a doc page.

| Option | What it does |
|---|---|
| Layout | Grid, List, or Featured and list |
| Number of posts | 3, 6, 9 or 12 |
| Source | All blogs, or one blog |
| Tag, Category | Any tag and Any category, or one of each. A category includes its subcategories |
| Order | Newest first, Oldest first, or Title A to Z |
| Split into pages | Yes shows the number of posts per page, with page links |
| Card shows | Show or Hide for Image, Date, Excerpt and Tags |
| Background, Vertical padding, Anchor | As on other blocks |
Only published posts are listed. In the editor, a list with nothing to show displays "No posts to list yet"; visitors never see this box. When the source is one blog and the list is not split into pages, it ends with a View all link to that blog.
Split into pages works only on the first post list of a blog home whose source is that blog. Anywhere else the field says: "Pages only work on the first post list of a blog home that lists that blog. Here the list shows its first posts."
When the blog home holds a post list split into pages, every publish writes these pages for you:
| Address | What it shows |
|---|---|
| /news/page/2, /news/page/3 | The next pages of posts |
| /news/tag/<slug> | The posts with that tag, for each tag a published post uses |
| /news/category/<slug> | The posts in that category and its subcategories |
A blog home without such a list writes none of these pages, and tags show as plain text instead of links.
Every blog also gets an RSS feed at /news/feed.xml, with its 20 newest posts, so readers can follow it in a feed reader.
