Switching from Subscribers to Members

Subscribers was an experimental feature in Ghost, which has now been deprecated. However, it's possible to collect email subscribers in a similar way using the Members (beta) feature. The following steps show how to update your custom Ghost theme to use Members for your subscribers.

The deprecated Subscribers featured used the {{subscribe_form}} helper to insert an email form into Ghost templates. This helper can be replaced with the following Members form:

<form data-members-form="subscribe">
  <input data-members-email type="email" required="true"/>
  <button type="submit">Subscribe</button>
  <p data-members-error><!-- error message will appear here --></p>
</form>

Alternatively, a partial can be used to emulate the subscription form helper. Using {{> subscription_form}} to reference the partial, and a partial file named subscription_form.hbs.

Supporting Subscribers & Members

Theme developers providing support for both Subscribers and Members can make use of @labs.subscribers and @labs.members to check if each of the beta features exist and are enabled.

Example

{{#if @labs.subscribers}}
    {{subscription_form}}
{{/if}}
{{#if @labs.members}}
    <form data-members-form="subscribe">
        <input data-members-email type="email" required="true"/>
        <button type="submit">Subscribe</button>
        <p data-members-error><!-- error message will appear here --></p>
    </form>
{{/if}}

More information on using Member forms check out our Members theme documentation.