A Collection shows a list of posts, tags, authors or membership tiers from your Ghost site. You design one item, such as a post card, and the Collection repeats it for every post or tag that Ghost returns. Use it for a blog feed, a grid of related posts, a page of your authors or a pricing table.
You can add a Collection to a Section or a Post Content section, and inside a Group, a No Results block or a Paywall. In the block picker it sits under Layout. Click a Collection on the canvas, or its row in the left sidebar, to open its settings in the right sidebar. In the tables below, "the + menu" is the + beside the name of a group of settings, such as General, in that panel.
On the canvas, a Collection lists demo posts, tags and authors until you choose your own site in the Preview data menu, as Preview with your Ghost content and members describes.
Ready versions
The picker offers the Collection on its own and in ready versions, which already hold a card.
Version
What it shows
Collection
An empty Collection. On the canvas it shows a card for each list it can hold, such as posts or tags. Click one to fill it, or add the blocks of the card yourself.
Posts
The latest posts in a grid of cards.
Posts list
The latest posts as rows, each image beside its text.
Tags
Tag cards with the tag's image and its number of posts.
Authors
Author cards with the author's photo and bio.
Post tags
The tags of one post in a line, each linked to its page, with a comma between them.
Post authors
The authors of one post, each with their photo and linked to their page.
Post tags and Post authors are offered inside a post's card and on post and page templates. Inside a card, the picker leaves out the versions that list your whole site.
General
These settings choose which items the Collection shows and how many. The settings in the middle of the table change with Source.
Setting
What it does
Source
What the Collection lists: Posts, Tags, Authors or Tiers from your site, or Post tags or Post authors, the tags or authors of the post around the Collection. Post tags and Post authors show inside a post's card and on post and page templates. A new Collection starts on Posts.
Show
Shows when Source is Posts. Which posts: Latest (the default), Featured, Related, Filter or Page posts. The table under this one compares them.
Filter
Shows when Show is Filter. A Ghost filter that picks the posts, such as tag:news for the posts tagged news, or tag:news+featured:true for the featured ones among them. Left empty, the Collection shows the latest posts.
Related by
Shows when Show is Related. Primary tag (the default) lists posts that share the first tag of the post on the page. Primary author lists posts by the same first author.
Fallback
Shows when Show is Related. What the Collection shows when no post is related: Latest posts (the default) or Hide section. Hide section hides the whole section, including its heading and other blocks.
Sort
The order of the items. For posts: Newest (the default), Oldest, Title (A-Z) or Title (Z-A). Posts set to Related or Page posts have no Sort: related posts come newest first, and page posts keep the order Ghost gives the page. For tags and authors: Name (A-Z), Name (Z-A), Most Posts (the default), Least Posts, Newest or Oldest. Tiers have no Sort, and Post tags and Post authors keep the order the post has them in.
Include Free
Shows when Source is Tiers. On by default, it lists your free tier beside the paid ones. Turn it off to show paid tiers only. Inside a Tiers Collection, the Price, Benefits and Tier Sign-up blocks show each tier's price, its benefits and a button to join it, as Show your membership tiers and prices explains.
Limit
How many items the Collection shows, from 1 to 100. The default is 6. With Page posts, it is empty by default, and the Collection shows every post of the page. A number smaller than Posts per page shows only the first posts of each page.
Start at
Which item comes first, from 1 to 100. Enter 2 to skip the first item, for example when another Collection above already shows it. Add it from the + menu beside General.
Layout
How the items sit: Stack (one under another), Row (side by side) or Grid (the default).
Wrap
Shows when Layout is Row. On by default, it moves items to a new line when the row is full. Turned off, they stay on one line and get narrower.
Max columns
Shows when Layout is Grid. The most items in one row of the grid, from 2 to 16. The default is 3.
Min column width
Shows when Layout is Grid. The narrowest an item can get, from 3 to 38 rem. The default is 14 rem, about 224 px. When the items can't keep this width, the grid shows fewer per row, so a phone shows one item per row.
Separated
Draws a thin line between the items. Add it from the + menu beside General.
Use Justification and Alignment on the canvas toolbar to arrange the Collection's items.
Posts that share the primary tag or the primary author of the post on the page. The post itself is left out.
Post templates. On other pages there is no post to compare with, so the Fallback applies.
Filter
The posts that match the Filter you enter.
Every template.
Page posts
The posts Ghost gives the page itself, split into pages: the home page's posts, a tag's posts, an author's posts, or the posts of a collection.
The Homepage, Collections, Tag and Author templates. On a post or a page it shows nothing.
Page posts is the only option that works with a Pagination block. How many posts each page has comes from Posts per page in Project settings › Features, 10 by default. Split post lists into pages explains it.
Layout
Setting
What it does
Alternate
Every second item lays out its blocks from right to left. With a card that has its image on the left, the images then switch sides from item to item. Add it from the + menu.
This part of the panel also holds Width, from the + menu, and Height when the Collection sits in a Group set to Stack. Layout settings describes them.
Spacing
Setting
What it does
Gap
The space between the items, Regular (40 px) by default. Click the link icon to set the space between columns and between rows separately.
Row gap
Shows when Layout is Row or Grid. The space between rows of items, when it should differ from the Gap. Empty, the rows use the Gap. Add it from the + menu.
Margin
Space outside the Collection, above, below and at the sides. Add it from the + menu.
Blocks inside a Collection
The blocks inside a Collection make up one item, and each one reads that item's data. A Title block shows the post's title, an Avatar shows the author's photo, a Post Count shows how many posts a tag has. The picker inside a Collection offers the data blocks that fit its Source. Show the post title and other page data explains data blocks.
To make a whole card open its post, tag or author page, select the Group that holds the card and turn on Link to its page. A Button inside a Collection has the same switch. Both show only inside a Collection.
An item holds only blocks that repeat with it: data blocks, Group, Paragraph, Button, Icon, Separator, Author Avatars, Author Social Links and No Results. A Collection goes inside another Collection only in a post's card, to list that post's tags or authors.
To show a block on every item but the last, such as the comma after each tag, give it the content condition Not the last item in its Display settings.
No Results
No Results is a service block that lives only inside a Collection. It holds what visitors see when Ghost finds nothing to list, such as a tag with no posts yet or a filter that matches nothing. A Collection without one shows nothing at all in that case.
To add it, click the + on the Collection's row in the left sidebar and select No Results under Layout. It starts with the paragraph "No results found.", which you can replace with a heading, a button or an image. A Collection holds one No Results.
On the canvas, No Results always shows under the items, inside a dashed outline, so you can edit it. On your site it shows only when the Collection has no items.
No Results has the settings of a Group without its link settings: Layout, Gap, Padding, colors and appearance.
A Collection shows a list of posts, tags, authors or membership tiers from your Ghost site. You design one item, such as a post card, and the Collection repeats it for every post or tag that Ghost returns. Use it for a blog feed, a grid of related posts, a page of your authors or a pricing table.
You can add a Collection to a Section or a Post Content section, and inside a Group, a No Results block or a Paywall. In the block picker it sits under Layout. Click a Collection on the canvas, or its row in the left sidebar, to open its settings in the right sidebar. In the tables below, "the + menu" is the + beside the name of a group of settings, such as General, in that panel.
On the canvas, a Collection lists demo posts, tags and authors until you choose your own site in the Preview data menu, as Preview with your Ghost content and members describes.
Ready versions
The picker offers the Collection on its own and in ready versions, which already hold a card.
Post tags and Post authors are offered inside a post's card and on post and page templates. Inside a card, the picker leaves out the versions that list your whole site.
General
These settings choose which items the Collection shows and how many. The settings in the middle of the table change with Source.
tag:newsfor the posts tagged news, ortag:news+featured:truefor the featured ones among them. Left empty, the Collection shows the latest posts.2to skip the first item, for example when another Collection above already shows it. Add it from the + menu beside General.Use Justification and Alignment on the canvas toolbar to arrange the Collection's items.
Layout, Wrap, Max columns and Min column width can have their own value on tablets and phones, as Change the design on tablets and phones explains.
Which posts each Show option lists
Page posts is the only option that works with a Pagination block. How many posts each page has comes from Posts per page in Project settings › Features, 10 by default. Split post lists into pages explains it.
Layout
This part of the panel also holds Width, from the + menu, and Height when the Collection sits in a Group set to Stack. Layout settings describes them.
Spacing
Blocks inside a Collection
The blocks inside a Collection make up one item, and each one reads that item's data. A Title block shows the post's title, an Avatar shows the author's photo, a Post Count shows how many posts a tag has. The picker inside a Collection offers the data blocks that fit its Source. Show the post title and other page data explains data blocks.
To make a whole card open its post, tag or author page, select the Group that holds the card and turn on Link to its page. A Button inside a Collection has the same switch. Both show only inside a Collection.
An item holds only blocks that repeat with it: data blocks, Group, Paragraph, Button, Icon, Separator, Author Avatars, Author Social Links and No Results. A Collection goes inside another Collection only in a post's card, to list that post's tags or authors.
To show a block on every item but the last, such as the comma after each tag, give it the content condition Not the last item in its Display settings.
No Results
No Results is a service block that lives only inside a Collection. It holds what visitors see when Ghost finds nothing to list, such as a tag with no posts yet or a filter that matches nothing. A Collection without one shows nothing at all in that case.
To add it, click the + on the Collection's row in the left sidebar and select No Results under Layout. It starts with the paragraph "No results found.", which you can replace with a heading, a button or an image. A Collection holds one No Results.
On the canvas, No Results always shows under the items, inside a dashed outline, so you can edit it. On your site it shows only when the Collection has no items.
No Results has the settings of a Group without its link settings: Layout, Gap, Padding, colors and appearance.
Settings shared with other blocks
The Collection also has the Display settings and Advanced settings of every block. The spacing names, such as Regular, come from Page widths and spacing.
Show a list of posts shows how to build a post feed, Choose which posts a list shows covers Featured, Related and filters, and Show your tags or authors covers the other sources.