Table of contents
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.