How to Manage Subscribers

The Subscribers feature lets you collect and view email subscribers who sign up through your public profile or blog posts. This guide covers connecting an email service, viewing subscribers, and understanding the subscription flow.

Prerequisites

Before you begin:

• You must be signed in to your account
• You must be a team owner (email service connection is owner-only)
• You need an account with a supported email service

Supported Email Services

Connecting an Email Service

Step 1: Navigate to Email Service Settings

1. From the sidebar, click Settings
2. Select Email Service from the settings menu
3. Or navigate directly to /dashboard/settings/email-service

Step 2: Choose Your Provider

Click on the email service you use. You'll see options for Mailchimp, ConvertKit, Beehiiv, and Buttondown.

Step 3: Authenticate

For OAuth services (Mailchimp, ConvertKit):

1. Click the Connect button
2. You'll be redirected to the service's login page
3. Authorize the connection
4. You'll be redirected back to your settings

For API Key services (Beehiiv, Buttondown):

1. Click the service card
2. Enter your API key (found in your service's settings)
3. Click Save

Step 4: Verify Connection

Once connected, you'll see:

• A green checkmark indicating active connection
• The connected account name or list
• Last sync time

Viewing Subscribers

Step 1: Navigate to Subscribers

From the sidebar, click Subscribers to access the dashboard.

Step 2: Browse Your Subscriber List

The subscribers page displays:

Step 3: Filter and Search

Use the filter bar to:

• Search — Find specific subscribers by email
• Filter by status — Show active, pending, or unsubscribed
• Sort — Order by date, email, or status

Step 4: View in External Service

Click View in [Service Name] to open your email service's dashboard for full management capabilities (add, edit, remove subscribers).

Note: The subscribers view in your dashboard is read-only. To add, edit, or remove subscribers, use your email service's dashboard directly.

How Visitors Subscribe

Subscribe forms appear automatically on:

• Your public profile page (/{username})
• Published blog posts (/{username}/{post-slug})

Subscription Process

1. Visitor enters email — They fill in the subscribe form
2. Confirmation email sent — A double opt-in email is sent automatically
3. Visitor confirms — They click the confirmation link
4. Subscription active — They appear in your subscriber list

This double opt-in process ensures compliance with CAN-SPAM and GDPR regulations.

Confirmation Flow

When a visitor subscribes:

1. They receive an email with a confirmation link
2. Clicking the link takes them to /confirm-subscription?token=...
3. The page automatically confirms their subscription
4. They see a success message

If confirmation fails:

• Invalid or expired tokens show an error message
• Visitors can subscribe again to receive a new confirmation link

Unsubscribe Handling

Subscribers can unsubscribe at any time:

1. They click the unsubscribe link in any email
2. They're directed to /unsubscribe?token=...
3. Unsubscription happens automatically
4. They see confirmation that they've been removed

Resubscribe Flow

If a previously unsubscribed user tries to subscribe again:

1. The form detects their previous unsubscription
2. They're shown a consent checkbox: "Yes, I want to subscribe again"
3. They must explicitly opt in to resubscribe
4. A new confirmation email is sent

Expected Result

After setting up subscribers:

• Subscribe forms appear on your public pages
• New signups go through double opt-in
• Confirmed subscribers appear in your dashboard
• You can view subscriber analytics in your email service

Troubleshooting

"Email Service Not Connected" message

You need to connect an email service before viewing subscribers:

1. Go to Settings > Email Service
2. Connect your preferred provider
3. Return to the Subscribers page

Subscribers not appearing

After connecting a new service:

• Sync may take a few minutes
• Click Refresh to manually trigger a sync
• Check that your email service list has subscribers

Subscribe form not showing

Subscribe forms only appear when:

• An email service is connected
• You're viewing a public profile or published blog post
• The visitor is not logged into your account

Confirmation emails not received

Ask subscribers to:

1. Check their spam/junk folder
2. Search for emails from your domain
3. Add your email to their contacts
4. Try subscribing again with a different email

"Previously unsubscribed" message

This appears when a subscriber who unsubscribed tries to resubscribe:

1. They need to check the consent checkbox
2. Click Resubscribe
3. Confirm via the new confirmation email

Best Practices

1. Verify your email service — Test the full flow before going public
2. Monitor spam complaints — High complaints affect deliverability
3. Keep lists clean — Regularly remove bounced emails (in your email service)
4. Respect unsubscribes — The system handles this automatically

Next Steps

• Publish your public profile — Where subscribe forms appear
• Create a blog post — Blog posts include subscribe forms
• Customize your profile — Make your public pages attractive

Related

• Public Profiles — How public pages work
• Blog — Managing blog content