Posts and site content

Show your tags or authors

A list of tags or authors is a Collection block, which repeats one card for each tag or author on your Ghost site. Use it on the Homepage, in a sidebar, or on a page of its own that lists your topics or writers.

Add a ready list

  1. Open your project in Fantasma.
  2. In the left sidebar, under Templates, click the template for the list, such as Homepage.
  3. On the canvas, point at the line between two sections and click +. An empty section appears.
  4. Click All patterns, the last card in the empty section. The Add Pattern to Template dialog opens.
  5. In its list of categories, click Tags or Authors.
  6. Click the pattern you want, such as Clean Topic Grid or Contributor Directory. It replaces the empty section.

The section stays linked to its pattern, and its Collection shows only Limit in the right sidebar. To change the order or the source, select the section and click Detach at the top of the right sidebar first.

To add a list to a section you already have, open the block picker and click Tags or Authors under Layout. Show a list of posts shows how to open the picker.

Choose the order and the number

  1. On the canvas, click the list until the whole Collection has a blue outline, or click its row in the Sections list. In the right sidebar, its name is followed by Collection.
  2. In Source, select Tags or Authors. The blocks in the card then read tags or authors, as the table in the next part shows.
  3. In Sort, select the order: Most Posts, the default, Least Posts, Name (A-Z), Name (Z-A), Newest or Oldest. Newest and Oldest go by when the tag or author was created in Ghost.
  4. In Limit, enter how many to show, from 1 to 100.
A tags list on the Homepage set to Source Tags, Sort Most Posts and Limit 8, with eight tag cards showing each tag's image, name and post count

Ghost leaves out tags and authors that have no published posts. Its tag list includes only public tags. Internal tags, whose names start with #, stay out.

What a card can show

The blocks inside the card read the tag or author they stand in. To add one, expand the Collection's row in the Sections list, point at the row under it, which holds the card, and click the + at its right end. Then pick the block under Data:

Block For a tag For an author
Title The tag's name The author's name
Excerpt The tag's description The author's bio
Featured Image The tag's image The author's cover image
Avatar Not available The author's profile image
Post Count How many posts, such as "12 posts" How many posts
Location Not available The author's location
Read More A button to the tag's page A button to the author's page

Author Social Links, under Content in the same picker, shows the author's website and social accounts. To make the whole name a link, select Title and turn on Make title a link.

You edit tags in Ghost Admin under Tags, and authors in their staff profile under Settings › Staff. A card leaves out a description, bio or location that is empty in Ghost. A tag without an image shows a placeholder in some patterns.

List a post's own tags or authors

On the Post template, or inside a post's card in a list of posts, a Collection can list the tags or the authors of that one post.

  1. Open the block picker in the section or the post card that should show them, as Add blocks to a section shows.
  2. Under Layout, click Post tags or Post authors.

Post tags shows the post's tags in a line, each linked to its tag's page, with a comma between them. The comma is a Paragraph named Separator with the content condition Not the last item, so the last tag has none. Click it on the canvas to type another separator. Internal tags stay out here too.

Post authors shows each author's photo and name, linked to their page. To switch a Collection you already have, set its Source to Post tags or Post authors.

The Tag and Author templates design the page each card links to. Which template Ghost uses for each page explains them.

Was this article helpful?