Posts and site content

Show sites you recommend

Ghost lets you recommend other sites to your readers. The Recommendations block shows them on your own pages, with each site's icon, title, domain and description. You add and edit the sites in Ghost Admin, and the block shows whatever is there, with no new theme needed.

Before you start

Add the sites in Ghost Admin, under Settings › Growth › Recommendations. The block shows nothing on your site until Ghost has recommendations. The canvas in Fantasma shows eight sample sites until you preview with your Ghost content.

Add a recommendations section

  1. Open your project in Fantasma.
  2. In the left sidebar, under Templates, click the template, 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 Recommendations.
  6. Click the pattern you want, such as Reading List. It replaces the empty section.
The Reading List pattern with a heading over eight recommended sites in two rows, each with its icon, title, domain and description

The section stays linked to its pattern, so only Limit and Min Width change in the right sidebar. To change the rest, select the section and click Detach at the top of the right sidebar.

To add the block to a section you already have, point at the section's row in the Sections list, click the + at its right end, and click Recommendations under Content in the block picker.

Choose what the block shows

Click the Recommendations row in the Sections list. In a section from a pattern, detach it first. The block's settings, in the right sidebar:

Setting What it does
Variant Plain, the default, with no box, Filled, a box with a light fill, or Outline, a box with a thin border. Background, Border, Corners and Text color change the cards further.
Sort Newest, the default, Oldest, Title (A-Z) or Title (Z-A). Newest and oldest go by when you added the site in Ghost.
Limit How many sites, from 1 to 20, and 8 by default.
Type How the cards line up: Grid, the default, in columns, Row side by side, or Stack one under another. With Grid, Columns sets the most cards in a row, 4 by default, and Min Width the narrowest a card gets before the grid shows fewer columns.
Separated Thin lines between the cards. On by default. To turn it off, click + next to General and select Separated first.
View Inside each card, Card puts the icon above the text and Row puts it beside the text.
Icon, Title, Domain, Description Turn each part of a card on or off.

Show a short list beside your posts

The Recommendations List custom block is a slim list with a "Recommendations" title, made for a sidebar. The default Homepage has one beside its latest posts. To add it, open the block picker the same way and click Recommendations List under Custom.

Each use of it has one setting, its title. The list inside shows 5 sites. To change that number, or to add a View All link that opens Ghost's own window with every site you recommend, edit the Recommendations List block itself, which changes it everywhere it is used. Change or detach a custom block shows how.

Was this article helpful?