Enable subscribers

SMS notifications are only sent when:

  • An incident/maintenance is created

  • When an incident/maintenance is resolved

  • When a maintenance begins

"Updates" to an incident or maintenance do not trigger SMS notifications. Email notifications, however, are sent for all updates (assuming the necessary notifications settings are selected on each update).

Some important notes

  • Currently, rate-limiting automatic subscriptions to 10 SMS subs per IP per 4 hours.

  • All US SMS subscriptions are initiated via short-code and these subscriptions require double opt-in by replying “YES”. SMS subscriptions for all other supported countries are initiated via long-code and will be required to double opt-in by tapping a link to confirm their subscription.

  • Statuspage uses Google’s reCAPTCHA for all self-serve subscriptions. Users that Google identifies as “bot-like” will be required to pass a CAPTCHA challenge. Most real (human) users won't be interrupted by the CAPTCHA challenge.

Enable/disable subscribers

Statuspage can send out notifications to your customers via email and SMS.

  1. Click Subscribers from the left sidebar if you have a private or public page.

    1. Click Audience instead if you're using an audience-specific page.

  2. Click Options, then select Settings from the options dropdown menu.

    1. Click the Subscriber settings tab instead if you're using an audience-specific page.

  3. Select which subscription types to allow. Uncheck boxes to disable the delivery type or subscription option for your page.

    1. To send Email/SMS notifications, make sure the necessary settings are enabled. SMS subscriptions are only enabled for paid plans, so you won't be able to configure them until you activate your page.

  4. Click Save changes.

Email subscriptions

Warning: Using a Distribution List (DL) as a subscriber can result in any of the recipients on the DL effectively unsubscribing everyone else. For this reason, we strongly encourage you to avoid subscribing a Distribution List to your page, and instead, subscribe individual email addresses.

The most common way that your users will subscribe to updates is through the Subscribe to updates button on your Statuspage.

A public status page with the subscribe options open

When they subscribe, they will receive an email with a confirmation button. The confirmation link must be clicked in order to receive any notifications; it expires after 90 days.

The confirmation email users get in order to confirm their subscription to page updates

Once the confirmation link is clicked, the user is taken back to the status page and that's it! As long as they remain a subscriber, they will receive updates when incidents are posted to the page.

API subscriptions

You can also add subscribers through the API. When using the Status API, users will receive an email (that expires after 90 days) requesting confirmation. If an authorized team member of an active page using the Manage API adds the user, they will have the option of bypassing email confirmation by passing skip_confirmation_notification with the value true.

Slack subscriptions

Allow page viewers to get incident updates and maintenance status messages in Slack. Learn more about Slack subscriptions.

Add subscribers via CSV

Finally, it’s also possible to use a .csv import to subscribe a large number of users. When using this method, an active page will also have the option of bypassing email confirmation.

What Email notifications look like:

An example Email notification subscribers receive for incident updates

SMS subscriptions

Your customers can also subscribe to receive SMS notifications for incidents. SMS messages are not charged individually per message - they are included in the cost of your subscription.

U.S. subscribers vs non-U.S. subscribers

Subscribers with U.S. phone numbers will be subscribed via SMS short-code. This requires confirming the subscription by replying YES to the subscription confirmation message. Subscribers with non-U.S. numbers will be subscribed via long-code, and this does not require confirming the subscription with 'YES'.

What SMS notifications look like:

An example text notification that SMS subscribers receive for incident updates

Unsubscribe from SMS notifications

End-users can unsubscribe from SMS notifications by replying STOP. (Note: some international carriers don't play nice with sending "STOP" messages, which may require those numbers to be unsubscribed through the UI by a Statuspage admin/team member).

Unsubscribe from Email notifications

End-users can unsubscribe from email notifications by clicking Unsubscribe on the email (this is only for pages that do not have Component Subscriptions enabled). For pages that do have Component Subscriptions enabled, the subscriber needs to click the 'Manage Subscriptions' link in an email notification and then fully opt-out of all component subscriptions on the following screen.

Unsubscribe from Slack notifications

End-users can unsubscribe from Slack notifications in a few ways:

  • Select Unsubscribe or Manage subscription from any message from the Statuspage app and confirm.

  • Visit the status page that they’re subscribed to, select Unsubscribe and confirm.

  • Remove the Statuspage app from your Slack workspace. See the Slack documentation to Remove an app.


Still need help?

The Atlassian Community is here for you.