Menu

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.

How a blog is built

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.

1. Create the blog home

  1. Open Pages and choose New page.
  2. Under Type, choose Blog home.
  3. Type a Title, such as "News". Check the Slug, which becomes the address.
  4. Leave Parent on the top level, or choose another page.
  5. Choose Create page.
The Pages screen: new page dialog, Type open.

2. Write a post

  1. Choose New page again and pick the Post type.
  2. If your site has more than one blog, choose it under Blog.
  3. Type the post's Title and choose Create page.
  4. 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.

3. Fill in the post settings

  1. In the editor, click an empty part of the canvas so no block is selected. The right panel shows the page settings.
  2. Fill in the Post section (table below).
  3. Choose Save.
The editor: post section of the right panel.
3. Fill in the post settings
FieldWhat it does
Date"The date the post first went live. You can change it." Empty until the first publish
ExcerptA short summary, up to 300 characters, shown on post list cards and in the feed
CoverThe post's image, shown in the post header and on cards
AuthorOptional. Shown under the title
Tags, CategoriesPick from the ones on the Tags and categories screen. See Tags and categories
Previous, NextAutomatic 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.

4. Publish

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".

List posts with the Post list block

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.

The editor: post list block selected.
List posts with the Post list block
OptionWhat it does
LayoutGrid, List, or Featured and list
Number of posts3, 6, 9 or 12
SourceAll blogs, or one blog
Tag, CategoryAny tag and Any category, or one of each. A category includes its subcategories
OrderNewest first, Oldest first, or Title A to Z
Split into pagesYes shows the number of posts per page, with page links
Card showsShow or Hide for Image, Date, Excerpt and Tags
Background, Vertical padding, AnchorAs 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."

Pages litetile writes for each blog

When the blog home holds a post list split into pages, every publish writes these pages for you:

Pages litetile writes for each blog
AddressWhat it shows
/news/page/2, /news/page/3The 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.