Subscribers
Subscribers get an email or a Discord message when you publish an incident or schedule maintenance on a status page. Visitors subscribe on the public page. An email address is confirmed with a link (double opt-in), and a Discord channel is confirmed on Discord. Only confirmed subscribers get updates.
Subscribe by email
- The visitor selects Subscribe in the header of the status page.
- The visitor types an email address and selects Subscribe.
- Spectate sends an email with the subject "Confirm your subscription to
<page>status updates". - The visitor selects Confirm subscription in the email. The link works for 7 days.
After step 4, the subscription is confirmed. Until then, it is pending and gets no updates. If the link expired, the visitor can subscribe again to get a new link.
The public page never shows if an address is already subscribed. To prevent abuse, Spectate accepts 10 subscribe requests per IP address per minute. It sends at most 3 confirmation emails per address per hour.
The Subscribe dialog also has an RSS / Atom tab with the feed URLs of the page.
Subscribe a Discord channel
A visitor can send the updates of a status page to a channel of their own Discord server. The visitor does not need a Spectate account, and the Spectate bot does not join the server. Spectate posts through a webhook that Discord creates for the channel.
- The visitor selects Subscribe in the header of the status page.
- The visitor selects the Discord tab.
- The visitor selects Add to Discord.
- On Discord, the visitor selects the server and the channel, then authorizes the webhook.
The visitor must have permission to manage webhooks in that server. Spectate then posts a first message in the channel and sends the visitor back to the status page. The subscription is confirmed at once, because the consent on Discord is the opt-in.
If the channel refuses the first message, Spectate removes the webhook and does not subscribe the channel. A forum channel refuses it, so the visitor must select a text channel. If a visitor subscribes the same channel again, the new webhook replaces the old one.
To prevent abuse, the limit of 10 subscribe requests per IP address per minute also applies here.
Follow a status page in Slack
A visitor can show new incidents and maintenance in a Slack channel with the /feed command of the Slack RSS app. The Slack workspace must have the RSS app.
- The visitor selects Subscribe in the header of the status page.
- The visitor selects the Slack tab.
- The visitor copies the command, for example
/feed subscribe https://<slug>.spectate.page/feed/rss. - The visitor sends the command in the Slack channel.
Slack reads the RSS feed. Spectate does not know about the channel, so the channel is not a subscriber. It does not show in the subscriber list and does not count towards the plan limit.
Slack posts each new item of the feed one time. An update to an incident keeps the date of the item, so Slack does not post the update.
To stop the messages, use /feed list in the channel to see the ID of the feed. Then use /feed remove <ID>.
Private status pages do not show the Slack tab, because Slack cannot open a private page.
Choose how visitors subscribe
A status page offers email, Discord, RSS and Atom feeds, and Slack by default. You can turn off each one in Settings → Display, under Ways to subscribe.
| Option | When you clear it |
|---|---|
| The Subscribe dialog has no email form. Spectate accepts no new email addresses and refuses confirmation links that are still open. | |
| Discord | The Subscribe dialog has no Discord tab. Spectate accepts no new Discord channels. |
| RSS and Atom | The page shows no links to the feeds. The feed URLs answer 404. Slack channels get no new messages. |
| Slack | The Subscribe dialog has no Slack tab. Channels that already use the command continue to get new items while the feeds are on. |
Slack needs RSS and Atom, so you cannot select it without the feeds. If you clear all options, the page has no Subscribe button. If only one option stays on, the dialog has no tabs.
Existing subscribers continue to get updates when you clear Email or Discord. To stop their updates, remove them in the subscriber list.
In the public API, the display settings are show_email_subscriptions, show_discord_subscriptions, show_feeds and show_slack_feed. The setting show_subscriptions controls the Subscribe button. If show_subscriptions is false, the page has no button, no Slack tab, and accepts no email or Discord sign-ups. The feeds follow show_feeds only.
What email subscribers get
Spectate sends one email per event to each confirmed email subscriber.
| Event | When | Subject starts with |
|---|---|---|
incident_created | You publish an incident. | New incident |
incident_updated | You post an update. | Incident update |
incident_resolved | You resolve an incident. | Resolved |
incident_writeup_published | You first publish a write-up and select Notify subscribers of the write-up. | Write-up |
maintenance_scheduled | You schedule maintenance. | Scheduled maintenance |
maintenance_started | A maintenance starts. | Maintenance in progress |
maintenance_completed | A maintenance completes. | Maintenance completed |
The subject has the form [<page>] <event>: <title>. The email shows the status, the impact, the affected components and the update text. A button opens the incident or maintenance on the status page. The sender name is the name of the status page.
The email uses the logo, name and brand colour of the page. Email clients do not show SVG images, so an email from a page with an SVG logo shows the page name instead.
When you publish, Notify subscribers is selected. Clear it to change the page without an email. Edits, deletes and changes to the impact timeline never send an email.
What Discord channels get
Each incident or maintenance has one message in a subscribed Discord channel. Spectate edits that message when the incident or maintenance changes, so a channel does not get a new message for each update. The message shows the status, the latest update, the affected components and a link to the status page. Times show in the time zone of the person who reads them. A mention in the text of an update does not notify anyone.
| Change | What Spectate does in the channel |
|---|---|
| An event from the table above, with Notify subscribers selected | Posts the message, or edits it if it exists. |
| A change with Notify subscribers cleared | Edits the message if it exists. Posts nothing new. |
| An edit of the title, an update or the impact timeline | Edits the message if it exists. Posts nothing new. |
| You delete the incident or maintenance | Deletes the message. |
If someone deletes the message on Discord, Spectate posts a new message at the next event with Notify subscribers selected.
Private pages
Subscribers of private pages also get updates. To subscribe to a private page, the visitor must first open the page.
Languages
Spectate sends emails and Discord messages in the language that the visitor saw when they subscribed. A confirmed email subscription keeps its language. If Spectate does not know the language, it uses the page language. Supported languages are English, Dutch, German, French, Spanish and Italian. See languages.
Spectate translates its own text: the subject, labels, dates, buttons and footer of an email, and the status and labels of a Discord message. Your incident titles, updates and component names stay as you wrote them. Dates show in UTC.
Unsubscribe
Every email has an Unsubscribe link. The link opens a page on the status page domain with an Unsubscribe button. Email clients that support one-click unsubscribe (the List-Unsubscribe header) can also remove the subscription without the page. Unsubscribing deletes the subscription.
A Discord message has no unsubscribe link, because every reader of the channel could use it. To stop the updates, a member of the server who can manage webhooks deletes the webhook under Edit Channel → Integrations → Webhooks. Spectate deletes the subscription at the next message that it cannot deliver.
Manage subscribers
The Subscribers tab of the status page lists all subscribers.
- The top of the tab shows the number of Confirmed and Pending subscribers, and New in the last 30 days.
- Filter by address, or by state: All, Confirmed or Pending.
- The table shows each Subscriber, its Channel, Language, State and when it Subscribed. A Discord subscriber shows its channel ID.
- Select Remove to delete a subscriber. Spectate does not tell the subscriber. For a Discord channel, the webhook stays in the server until someone deletes it.
Owners, managers and admins can remove subscribers. Members can see the list. You cannot add subscribers by hand. Each person subscribes on the public page.
Plan limits
The limit is the number of confirmed subscribers of all status pages of the team together. A Discord channel counts as one subscriber. Pending subscriptions do not count.
| Plan | Confirmed subscribers |
|---|---|
| Starter | 250 |
| Team | 2,500 |
| Business | 25,000 |
During the 14-day trial, the Team limit applies. When the team reaches its limit, visitors cannot subscribe by email or with Discord, and pending subscribers cannot confirm. The Subscribe button stays for the feeds and Slack, if they are on. These do not count towards the limit. Existing subscribers continue to get updates. See the pricing page.
Related
- Status page incidents
- Status page subscribers in the API reference. The API lists email subscribers only.