Members and forms

Add sign-in, sign-up and account buttons

Ghost's Portal is the window where readers sign up, sign in, and manage their account and newsletters. Any Button in your theme can open it at the page you choose. The default header already has Sign in, Subscribe and Account buttons. To find them, click Layouts in the icon rail and open Navigation > Top row > Right > Member buttons in the Sections list.

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. Without members, Portal does not open.

Make a button open Portal

  1. Open your project in Fantasma.
  2. Click the button on the canvas, or add one from the block picker, as Add blocks to a section shows.
  3. In the button's settings in the right sidebar, under General, enter the button's words in Label, such as Sign in.
  4. In On click, select Open Portal. A Portal page setting appears.
  5. In Portal page, select the page Portal opens at.
The Become a member button of a paywall selected, with On click set to Open Portal and Portal page set to Sign up

The paywall of a locked post uses such a button: Become a member opens Portal at Sign up.

Portal page What the reader sees
Sign up The sign-up form, with the tiers Portal offers. The default.
Sign in The sign-in form, where members get a sign-in link by email.
Account The member's account: their email, plan and newsletters.
Plans The tiers a member can upgrade to.
Profile The member's name and email, to change them.
Newsletters The newsletters the member gets, to turn each on or off.
Recommendations The sites you recommend in Ghost.

Portal's look, such as its colors and the tiers it offers, is set in Ghost Admin under Settings > Membership > Signup portal.

Show each button to the right readers

A visitor needs Sign in and Subscribe. A member needs Account. Give each button an audience, and Ghost shows only the right ones.

  1. Select the button.
  2. In its settings, scroll down to the Display group, click the + next to it, and select Audience.
  3. In Audience, select Visitors for Sign in and Subscribe buttons, Members for an Account button, or Free members for an upgrade button that opens Plans.

On the canvas, the page shows as a visitor sees it, so a button set to Members disappears. To see it, open the Preview data menu at the top of the right sidebar and select Free member or Paid member under Preview as. Preview with your Ghost content and members explains the menu.

Show content only to members or some tiers lists every audience.

A link can open Portal too. Its address is #/portal/ followed by the page, such as #/portal/signup or #/portal/account/plans. Enter it as a button's Link URL with On click set to Open link, as the default header does, as a link in a paragraph, or as a menu item in Ghost Admin's navigation.

Ghost can also show its own round Portal button in a corner of every page. Turn it off in Ghost Admin under Settings > Membership > Signup portal, with Show portal button, when your theme has its own buttons.

The buttons work on your Ghost site once the theme is there, as Publish your theme to Ghost shows.

Was this article helpful?