Subscribers Beta

Note: Your theme must support subscribers to use this feature. You can view documentation on how to add the subscribers feature to your theme here. The default theme, Casper, has already been upgraded to support it.

The current version of subscribers does NOT send emails. This will come in a future version.

In Ghost 0.8, we’ve added ‘beta’ version of Subscribers. The new Subscribers feature allows you to capture email addresses on your blog, which can then be exported and imported. In future versions we’ll be adding tools for setting up regular email newsletters to be sent to this list, as well as much, much more.

What does ‘Beta’ mean?

In this case, we’re using the word ‘Beta’ to indicate that this is early access to an incomplete feature. You should expect that it won’t always work correctly and that it may change in breaking ways. So please don’t use it in production or on a blog where you care that everything works correctly.

Why does the Subscriber feature need a ‘Beta’ phase?

The functionality we’ve added to Ghost to support Subscribers is new and hasn’t been tested by many users or theme developers. We’re using the Beta phase to collect feedback on the feature, and make changes to make things as intuitive and easy to use as we can. If you try out the feature, please leave us feedback either on our slack team page or email [email protected] – your feedback is very important to help us remove the ‘Beta’ label from these features.

Enable Subscribers Feature

Note: The current version of subscribers does NOT send emails. This will come in a future version.

  1. Log in to your publication at http://subdomain.ghost.io/ghost/signin
  2. Click Settings > Labs.
    ghost1.0-admin-menu-labs.png
  3. Check the box for Subscribers, under the Enable Beta Features.
    Screen_Shot_2017-07-27_at_7.35.49_AM.png

View Subscribers

  1. Click Subscribers from the admin menu.
    Screen_Shot_2017-07-27_at_7.50.00_AM.png

Delete Subscribers

  1. From Subscribers, hover over the subscriber to reveal a trashcan iconsubscribers-delete.png
  2. Click on the trashcan.png icon.
  3. Confirm your action by clicking Delete.
    delete-subscriber.png

Add Subscribers

  1. Click Subscribers from the admin menu.
  2. Click the Add Subscriber button.
  3. Enter in the email address you'd like to add.
  4. Click the Add button.

Export Subscriber List

  1. Click Subscribers from the admin menu.
  2. Click the Export CSV button.
  3. Save your .CSV export file.

Import Subscriber List

  1. Click Subscribers from the admin menu.
  2. Click the Import CSV button.
  3. Click inside the uploader box.
  4. Locate your CSV file for import.
  5. Subscribers will import immediately upon upload.

Import file format
The import file must follow this structure:

email,
[email protected],
[email protected]
Note: You must include “email,” at the top of your .csv file, otherwise the import will fail.

If the import was successful, Ghost will out put how many subscribers were added, how many duplicates there were, and how many email addresses were invalid.