A post list is a Collection block set to Posts. It lists the posts Ghost gives it for its Show option. Its settings show in the right sidebar when you select it, as Select blocks inside a section shows. Collection describes each one.
If the list is wrong only on the canvas, start with the first two checks below and "The filter matches nothing". If it is wrong only on your site, start with the last check below and "The home page leaves out some posts".
Check the basics first
The canvas shows demo posts until you select Connected site in the Preview data menu, the icon next to Download or Publish at the top of the right sidebar. Demo posts have their own tags and featured posts, so a list can look right on the canvas and differ on your site. See Preview with your Ghost content and members.
With Connected site, the canvas has only your 20 newest published posts. A list of older posts, such as an older featured post, can be empty on the canvas and still work on your site.
Ghost lists only published posts, never drafts or scheduled posts.
Your site shows a changed list only after you publish the theme. See My changes don't show on my Ghost site. A post you feature or tag in Ghost shows on your site at once, without a new theme.
Featured shows nothing
Show set to Featured lists only posts marked as featured in Ghost. In Ghost Admin, open a post's settings and turn on its featured option, or set Show to Latest.
Related shows the latest posts, or nothing
Related compares posts with the post on the page, so it works only on post templates. On other pages, and on a post with no other posts sharing its first tag or first author, the Collection uses its Fallback: Latest posts, or no posts at all with Hide section, which hides only the list, not the section. The section's heading then stays above an empty space. Give your posts tags in Ghost, or set Related by, which shows under Show when it is Related, to Primary author. A post's first tag and first author are the ones Ghost calls primary.
Page posts shows nothing
Page posts lists the posts Ghost gives the page itself. It works on the Homepage, Collections, Tag and Author templates, which you pick in the Templates list. The templates under Collections design the list page of each collection, such as /projects/. How many posts each page shows comes from Posts per page in Project settings › Features, not from Limit. On the Post or Page template it shows nothing. Use Latest or Filter there.
The filter matches nothing
With Show set to Filter, a Filter field appears. It takes Ghost's filter syntax.
Use the tag's slug, not its name: tag:product-news, not tag:Product News. Find the slug in Ghost Admin under Tags.
An internal tag, whose name starts with #, has a slug that starts with hash-: tag:hash-hidden for #hidden.
Join two conditions with + for both, or , for either: tag:news+featured:true.
A minus leaves a tag out: tag:-hash-hidden lists every post without #hidden.
The canvas understands only a single tag, such as tag:news, and featured:true. With any other filter, the canvas shows posts that do not match it, or none at all. Check such a list on your site.
The home page leaves out some posts
When you add a collection, such as /projects/, its posts leave your main post list. A post with the collection's Internal tag, the tag set in the collection's settings, shows only in that collection. Remove the tag from the post in Ghost if it belongs in the main list. Create a part of your site with its own URL explains collections.
A new collection, or a changed address, also needs the new routes.yaml in Ghost. Until Ghost has it, the collection's page shows no posts or an error page. See Upload routes.yaml.
Fewer posts than you expect
Limit sets how many posts show, 6 by default. Start at picks the first post to show: 3 skips two posts and starts with the third newest. To skip the 3 posts another list shows, enter 4. Such a list comes up empty when the site has only those few posts.
Posts show in the wrong order
The order comes from Sort, in the Collection's settings under Show: Newest, Oldest, Title (A-Z) or Title (Z-A). Related and Page posts have no Sort: related posts come newest first, and page posts keep Ghost's order.
Show a message when the list is empty
Add a No Results block to the Collection, so visitors see a line such as "No posts yet" instead of an empty space. Collection shows how.
A post list is a Collection block set to Posts. It lists the posts Ghost gives it for its Show option. Its settings show in the right sidebar when you select it, as Select blocks inside a section shows. Collection describes each one.
If the list is wrong only on the canvas, start with the first two checks below and "The filter matches nothing". If it is wrong only on your site, start with the last check below and "The home page leaves out some posts".
Check the basics first
Featured shows nothing
Show set to Featured lists only posts marked as featured in Ghost. In Ghost Admin, open a post's settings and turn on its featured option, or set Show to Latest.
Related shows the latest posts, or nothing
Related compares posts with the post on the page, so it works only on post templates. On other pages, and on a post with no other posts sharing its first tag or first author, the Collection uses its Fallback: Latest posts, or no posts at all with Hide section, which hides only the list, not the section. The section's heading then stays above an empty space. Give your posts tags in Ghost, or set Related by, which shows under Show when it is Related, to Primary author. A post's first tag and first author are the ones Ghost calls primary.
Page posts shows nothing
Page posts lists the posts Ghost gives the page itself. It works on the Homepage, Collections, Tag and Author templates, which you pick in the Templates list. The templates under Collections design the list page of each collection, such as
/projects/. How many posts each page shows comes from Posts per page in Project settings › Features, not from Limit. On the Post or Page template it shows nothing. Use Latest or Filter there.The filter matches nothing
With Show set to Filter, a Filter field appears. It takes Ghost's filter syntax.
tag:product-news, nottag:Product News. Find the slug in Ghost Admin under Tags.#, has a slug that starts withhash-:tag:hash-hiddenfor#hidden.+for both, or,for either:tag:news+featured:true.tag:-hash-hiddenlists every post without#hidden.The canvas understands only a single tag, such as
tag:news, andfeatured:true. With any other filter, the canvas shows posts that do not match it, or none at all. Check such a list on your site.The home page leaves out some posts
When you add a collection, such as
/projects/, its posts leave your main post list. A post with the collection's Internal tag, the tag set in the collection's settings, shows only in that collection. Remove the tag from the post in Ghost if it belongs in the main list. Create a part of your site with its own URL explains collections.A new collection, or a changed address, also needs the new
routes.yamlin Ghost. Until Ghost has it, the collection's page shows no posts or an error page. See Upload routes.yaml.Fewer posts than you expect
Limit sets how many posts show, 6 by default. Start at picks the first post to show:
3skips two posts and starts with the third newest. To skip the 3 posts another list shows, enter4. Such a list comes up empty when the site has only those few posts.Posts show in the wrong order
The order comes from Sort, in the Collection's settings under Show: Newest, Oldest, Title (A-Z) or Title (Z-A). Related and Page posts have no Sort: related posts come newest first, and page posts keep Ghost's order.
Show a message when the list is empty
Add a No Results block to the Collection, so visitors see a line such as "No posts yet" instead of an empty space. Collection shows how.
Contact support
If none of these explain it, contact us and send: