Status Page Subscriptions

Allow users to subscribe to your status page for email notifications on incidents, maintenance, and status changes.

Subscription Flow

1. User visits status page
2. Clicks "Subscribe to Updates"
3. Enters email address
4. Receives verification email
5. Clicks verification link
6. Subscribed! ✅

Notifications sent for:
- New incidents created
- Incident status updates
- Incidents resolved
- Scheduled maintenance
- Component status changes

Subscriber Limits

Subscription Preferences

Subscribers can choose what notifications to receive:

Email Templates

Incident Created

Subject: [Incident] Production API Down

Hi there,

We're currently experiencing an incident with our API service.

Incident: Production API Down
Status: Investigating
Started: Feb 13, 2026 10:30 AM UTC
Affected Components: API

Details:
We are investigating reports of API failures. Our team has been 
notified and is actively working on resolving this issue.

We'll provide updates as we learn more.

[View Status Page] [Manage Subscription]

---
Example Status - Powered by BlackTide

Incident Update

Subject: [Update] Production API Down

Hi there,

We have an update on the ongoing incident.

Incident: Production API Down
Status: Identified
Updated: Feb 13, 2026 10:35 AM UTC

Update:
We have identified the root cause as a database connection pool 
exhaustion. We are restarting the service to clear the pool.

[View Status Page] [Manage Subscription]

Incident Resolved

Subject: [Resolved] Production API Down

Hi there,

Good news! The incident has been resolved.

Incident: Production API Down
Status: Resolved
Downtime: 8 minutes 42 seconds
Resolved: Feb 13, 2026 10:38 AM UTC

Resolution:
Service has been restarted and is now operational. All systems 
are running normally.

Thank you for your patience.

[View Status Page] [Manage Subscription]

Managing Subscribers

View Subscribers

1. Go to Status Pages → Select your page
2. Click Subscribers tab
3. View list of all subscribers
4. See verification status, joined date

Subscriber Actions

• Resend Verification: For unverified subscribers
• Remove Subscriber: Manually unsubscribe user
• Export List: Download CSV of all subscribers

Subscription Widget

The subscribe form appears on your status page:

┌─────────────────────────────────────────┐
│  Subscribe to Updates                   │
│                                          │
│  Get notified when we create, update or │
│  resolve incidents.                     │
│                                          │
│  ┌──────────────────────────────────┐   │
│  │ your@email.com                   │   │
│  └──────────────────────────────────┘   │
│                                          │
│  [Subscribe]                             │
└─────────────────────────────────────────┘

Unsubscribe Flow

Subscribers can unsubscribe at any time:

1. Click "Manage Subscription" link in any email
2. Redirected to preferences page
3. Click "Unsubscribe"
4. Confirmation: "You've been unsubscribed"

One-Click Unsubscribe

All emails include List-Unsubscribe header for email clients:

List-Unsubscribe: <https://blacktide.xyz/unsubscribe/abc123>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

Email Delivery

Infrastructure

• Provider: AWS SES (Simple Email Service)
• Deliverability: 99.5% inbox rate
• Speed: <30 seconds delivery
• Authentication: SPF, DKIM, DMARC configured

From Address

From: Example Status <status@mail.blacktide.xyz>
Reply-To: support@example.com (optional, configurable)

Compliance

CAN-SPAM Act

• ✓ Clear "From" address
• ✓ Accurate subject lines
• ✓ Physical mailing address in footer
• ✓ Clear unsubscribe link
• ✓ Honor opt-outs within 10 days

GDPR

• ✓ Double opt-in (email verification)
• ✓ Clear consent (subscription form)
• ✓ Data portability (export subscribers)
• ✓ Right to deletion (unsubscribe)

Analytics

Track subscription metrics:

Best Practices

1. Verify Emails Quickly

• Set verification email subject: "Verify your subscription to Example Status"
• Make verification link prominent
• Include fallback URL if button doesn't work

2. Don't Over-Notify

• Send updates every 30-60 minutes (not every 5 min)
• Batch minor updates
• Only send resolved email when fully resolved

3. Clear Communication

• Subject: [Incident] or [Resolved] prefix
• First line: Current status
• Second line: Affected components
• Body: What's happening, what we're doing

4. Test Before Launch

• Subscribe yourself
• Trigger test incident
• Verify emails arrive
• Check links work
• Test unsubscribe flow

API Access

Manage subscribers programmatically:

# List subscribers
GET /v1/status-pages/:id/subscribers

# Add subscriber
POST /v1/status-pages/:id/subscribers
{
  "email": "user@example.com"
}

# Remove subscriber
DELETE /v1/status-pages/:id/subscribers/:subscriberId

Troubleshooting

Verification Emails Not Arriving

Solution:

• Check spam folder
• Whitelist status@mail.blacktide.xyz
• Resend verification email
• Wait 5-10 minutes for delivery

Subscriber Count Not Increasing

Possible Causes:

• Plan limit reached (upgrade to Pro)
• Subscribers not verifying emails
• Form not visible on status page

Next Steps

• Components: Configure monitored services
• Branding: Customize logo and colors
• Status Pages Overview: Full guide
• Status Pages API: Programmatic control