Members and forms

Show content only to members or some tiers

Any block or section can be shown to some readers only: a "Thanks for subscribing" note for members, a sign-up call for visitors, or a bonus link for one paid tier. Ghost decides on each page load who the reader is, and leaves the block out for everyone else.

The rule works on the blocks and sections of your theme, such as a button in the header or one section of the home page. To lock a post's text itself, set its access in Ghost Admin, and see Change what readers see on a locked post.

Before you start

  • Members are on in Ghost Admin. Under Settings > Membership > Access, Who should be able to subscribe to your site? is not Nobody. While members are off, every block with an audience other than Everyone stays hidden from everyone, a Visitors block included.
  • To show blocks to some tiers, your tiers exist in Ghost Admin under Settings > Membership > Tiers.

Choose who sees a block

  1. Open your project in Fantasma.
  2. Click the block on the canvas. For a whole section, click its row in the Sections list in the left sidebar. The sections you add to a template, such as a newsletter section, have this rule. The header, the footer and dialogs do not, so set it on the blocks inside them.
  3. In the settings in the right sidebar, scroll down to the Display group, click the + next to it, and select Audience.
  4. In Audience, select who sees it.
A newsletter section selected on the home page, with Audience set to Visitors in its Display settings
Audience Who sees it
Everyone All readers, with members on or off. The default.
Everyone, if memberships are enabled All readers, but only while members are on. Use it for a Subscribe button that makes no sense on a site without members.
Visitors Readers who are not signed in.
Members Every signed-in member, free or paid.
Free members Signed-in members without a paid subscription.
Paid members Members with a paid subscription.
Selected tiers Paid members of the tiers you list.

To remove the rule, open the same + menu and select Audience again. The menu checks the rules in use.

Show a block to some tiers

  1. In Audience, select Selected tiers. A Tier names field appears.
  2. In Tier names, enter one tier name per line, such as Supporter and Patron.

Type each name exactly as it is in Ghost, capitals included. If you rename a tier in Ghost, change it here too. The block shows to a member whose subscription in one of these tiers is active or in a trial. It also shows while a payment has failed and Ghost marks the subscription unpaid or past due, until Ghost ends it. A free tier never matches; use Free members for it. With no names, the block shows to nobody.

Check each view on the canvas

The canvas shows the page as a visitor sees it, so a block set to Members disappears from it as soon as you choose that audience. Its row stays under its section in the Sections list, where you can still select it.

  1. At the top of the right sidebar, click the Preview data icon, next to Download. The Preview data menu opens.
  2. Under Preview as, select Free member or Paid member. The blocks for that reader appear.
  3. Optional. With Paid member, enter a tier's name in Tier name to see the blocks for that tier.

Switch back to Visitor when you are done. Preview with your Ghost content and members explains the menu.

What the rule does on your site

Ghost leaves a hidden block out of the page it sends, so it is not in the page's source either.

An audience works together with the other rules under Display. A block set to Members and hidden on phones shows to members on tablets and desktops only. Display settings lists every rule.

The rule reaches your site when you publish the theme again, as Publish your theme to Ghost shows.

Was this article helpful?