Ghost Subscriber Management — Member Profiles, Segments and Analytics

In this tutorial, you'll learn how to manage subscribers in Ghost — member profiles, labels for segmentation, member analytics, importing and exporting member data, and strategies for keeping members engaged.

What You'll Learn

• The member profile and its data fields
• Member lists: viewing, filtering, and searching
• Labels for member segmentation
• Importing members from CSV
• Exporting member data
• Member analytics: growth, engagement, churn
• Email engagement tracking per member
• Managing member subscriptions and tiers
• Member deletion and GDPR Compliance
• Strategies for member retention and engagement

Why It Matters

Your members are your revenue source. Understanding who they are, how they engage, and when they are at risk of churning is essential for a successful membership business. Ghost gives you the tools to manage members individually and in bulk, segment them for targeted communication, and track engagement over time. Without subscriber management, you are flying blind — hoping members stay without knowing why they leave.

Real-World Use

A membership site with 5,000 members uses labels to segment their audience: "active_reader" (members who open 80%+ of emails), "at_risk" (members who have not opened an email in 30 days), and "power_user" (members who comment regularly). They export the "at_risk" segment, send a re-engagement campaign, and recover 15% of at-risk members before they churn.

Learning Path

flowchart LR
  A["Newsletter Setup"] --> B["Subscriber Management
You are here"]:::current
  B --> C["Membership API"]
  C --> D["Content API"]

  classDef current fill:#38bdf8,color:#0f172a,stroke-width:2px

Member Profiles

Every member has a profile in Ghost. Click a member in the Members list to see their full profile.

Profile Fields

Profile Sections

• Overview: Name, email, status, tier, join date
• Subscription: Current tier, price, billing cycle, next payment date
• Email: Engagement stats for newsletter emails
• Timeline: Activity history (posts viewed, comments, emails opened)
• Labels: Tags for segmentation
• Notes: Private notes (visible only to staff)

Managing Member Lists

Viewing Members

Go to Members in the admin sidebar.

The member list shows all members with:

• Name and email
• Tier and status
• Join date
• Labels
• Email engagement (opens, clicks)

Filtering

Filter members by:

• Status: Active, Expired, Canceled, Comped
• Tier: Free, Monthly, Yearly
• Labels: Custom labels you have created
• Date range: Joined between specific dates
• Search: By name or email

Bulk Actions

Select multiple members for bulk actions:

• Change tier
• Add or remove labels
• Subscribe or unsubscribe from emails
• Export selected
• Delete selected

Labels for Segmentation

Labels are tags for members. They let you group members for analysis and targeting.

Creating Labels

Labels are created on the fly. When you add a label to a member, type the label name. If it does not exist, Ghost creates it.

Label Use Cases

Automating Labels

Ghost does not automatically add labels based on behavior. You must:

• Manually add labels as you review members
• Export member data and analyze in a spreadsheet
• Use the Admin API to programmatically add labels based on conditions

Filtering by Labels

<!-- In theme, check member labels -->
{{#if @member.labels}}
  {{#foreach @member.labels}}
    <span>{{name}}</span>
  {{/foreach}}
{{/if}}

Importing Members

You can import members from a CSV file.

CSV Format

email,name,subscribed_to_emails,stripe_customer_id,labels,note
john@example.com,John Doe,true,cus_xxx,active;newsletter,Joined from Twitter
jane@example.com,Jane Smith,true,,new,

Required Fields

• email — Member email (required)
• Other fields are optional

Optional Fields

• name — Display name
• subscribed_to_emails — true or false
• stripe_customer_id — For existing Stripe customers
• labels — Semicolon-separated label names
• note — Internal note

Import Steps

1. Go to Members > Settings > Import members.
2. Upload your CSV file.
3. Ghost maps the columns and shows a preview.
4. Confirm the import.

Notes on Import

• Duplicate emails are skipped (not updated)
• Labels are appended (existing labels are not removed)
• Imported members are created as Free tier by default
• For Stripe customers, add the stripe_customer_id to connect existing subscriptions

Exporting Members

Full Export

1. Go to Members > Settings > Export members.
2. Click "Export."
3. A CSV file downloads with all member data.

Export Fields

id,uuid,email,name,note,created_at,deleted_at,labels,subscriptions,tiers

The export includes all members, their labels, subscription history, and tier information.

Selective Export

You cannot export a filtered subset directly from the admin. Workarounds:

• Export all and filter in a spreadsheet
• Use the Admin API to query specific member segments
• Manually select members and use bulk export

Member Analytics

Ghost provides analytics at the member level and site level.

Site-Level Analytics

In the Dashboard:

• Total members: Current total
• Paid members: Count of paying members
• Member growth: Chart of new members over time
• Email open rate: Average open rate
• Email click rate: Average click rate
• Top posts: Most-viewed content

Member-Level Analytics

In each member's profile:

• Email opens: How many newsletters they opened
• Email clicks: How many links they clicked
• Last email opened: Date of last email open
• Last seen: Last site visit timestamp
• Activity timeline: Posts viewed, emails opened, subscription changes

Calculating Churn

Ghost does not calculate churn rate automatically. Calculate it manually:

Monthly churn rate = Canceled members this month / Total members at start of month

Example: 50 members canceled in a month out of 1,000 = 5% monthly churn.

Member Communication

Email to Members

You can email members directly from Ghost:

• Newsletters (published posts)
• Magic link emails (automatic)
• Password reset emails (automatic)
• Signup confirmation (automatic)

You cannot send a one-off broadcast email to all members (like a Mailchimp campaign) directly from Ghost. Every email is tied to a post.

Third-Party Integration

For advanced email campaigns:

• Export member emails from Ghost
• Import into Mailchimp, ConvertKit, or ActiveCampaign
• Send separate campaigns from there
• Keep both systems in sync

GDPR and Member Data

Ghost provides privacy tools for member data management.

Member Rights

• Access: Members can view their data in the Portal
• Export: Members can request their data export
• Deletion: Members can request account deletion
• Correction: Members can update their profile in the Portal

Admin Actions

• Delete member: Permanently removes the member and their data
• Anonymize: Removes personal data but keeps anonymized analytics
• Export member data: Download all data for a specific member

Common Mistakes

1. Not using labels for segmentation: Without labels, all members look the same. You cannot target at-risk members, reward loyal ones, or analyze acquisition channels. Use labels from day one.

2. Importing members without consent: Adding people to your member list without their consent violates GDPR and anti-spam laws. Only import members who have explicitly opted in.

3. Not cleaning the member list: Members who never open emails or bounce hurt your sender reputation. Regularly export the list, identify inactive members, and consider removing them.

4. Overlooking the activity timeline: The member timeline shows exactly what content a member engaged with. Use this to understand which content drives subscriptions and which does not.

5. Forgetting to set notes on members: If a member emails support with a question, add a note to their profile. Next time you review the member, you see the full history and context.

Practice Questions

1. What are member labels used for in Ghost? Answer: Labels are tags for segmenting members — grouping them by behavior, source, value, or any attribute. You can filter members by labels, export label-based segments, and use labels for targeted analysis.

2. How do you import existing subscribers into Ghost? Answer: Prepare a CSV file with columns for email (required), name, subscribed_to_emails, labels, and note. Go to Members > Settings > Import members, upload the CSV, verify the mapping, and confirm the import.

3. What member analytics does Ghost provide? Answer: Ghost provides site-level analytics (total members, paid members, growth chart, open/click rates) and member-level analytics (individual email opens/clicks, last seen, activity timeline). Churn rate is not automatically calculated.

4. Challenge: Create a member segmentation Strategy for a membership site with 1,000 members. Define at least 5 labels for different segments (e.g., inactive, engaged, premium, at-risk, new). Then export the member list, analyze it in a spreadsheet, and write a re-engagement plan for the at-risk segment.

FAQ

Mini Project

Your task: Build a complete member management system.

1. Create 10 test members with different tiers and statuses (free, monthly, yearly, comped, canceled).
2. Add labels to each member: "new", "active", "at_risk", "vip".
3. Export the member list as CSV.
4. Analyze the export in a spreadsheet — calculate the percentage of members in each tier and label group.
5. Create a re-engagement email plan for "at_risk" members.
6. Document your member management workflow for ongoing use.

This exercise gives you hands-on experience with the complete member lifecycle.

What's Next

Now that you understand member management, learn how to extend memberships with the API:

Continue to Lesson 24: Membership API — Custom signup flows, membership portal, and API-based member management.

Related lessons:

• Content API — Query content via REST API
• Admin API — Admin-level API operations