Component subscriptions are a great way to ensure that your subscribers are only getting notifications that are relevant to them. Subscribers can pick and choose which components they want to receive notifications about and which they don't.
The best part about this feature is that we do the magic behind the scenes to figure out who should be messaged about which incidents, and make sure that they receive all of the relevant notifications based on their preferences. Usage of Statuspage.io from a management perspective is exactly the same, and you can open, close, and update incidents whenever you like - we've got your back to make sure your subscribers are always up to date.
A realistic example
To start, let's imagine you have 4 components -
Management Portal, and
One day, your database begins to incur unexpected I/O wait and things start to slow down. The Management Portal is very much affected by this - requests are timing out - but other services are still working fine.
- Click Incidents from the left sidebar.
- Click Create incident.
- Create an incident about the timeouts and only select
Management Portalas an affected Component.
By default, when you select at least 1 affected Component, the Send notifications checkbox is selected. However, you have the option to deselect that if you do not want to notify subscribers but still want to show users that this incident affects a certain component. For this example, let's assume we want to notify subscribers.
4. Click the box next to Send notifications to select.
5. Click Create.
Upon incident creation, we'll check to see which of your subscribers are subscribed to
Management Portal notifications, and we'll shoot them a note about the new incident.
Time goes on, you update the incident a couple more times, and eventually, the database slows to a crawl, making the API slow to respond as well.
At this point, API subscribers need to be notified of this incident.
- Click Incidents from the left sidebar.
- Click Update for the ongoing incident.
- Click Edit next to Components affected.
- Select API as an affected component and choose the status from the dropdown menu.
- Click Update.
Behind the scenes, we notice that all of the API subscribers are now affected by this incident, and they haven't been notified of anything yet. We gather all of them up, and send them the most recent incident update you created to let them know that there's an issue.
How to enable component subscriptions
Enabling component subscriptions requires that you be on a Business level plan.
- Navigate to Subscribers from the left sidebar.
- Click the Options drop down menu.
- Click Settings.
- Select at least one Subscription option from those listed.
- Click Save changes.
The screenshot below illustrates your other options alongside component subscription capabilities.
What your subscribers see
With the basic signup flow, they simply get a success message and a confirmation in their inbox. Once component subscriptions are enabled, subscribers will be taken to another screen where they can immediately fine tune their subscription to just the components that interest them.
What happens when new components are added?
If a subscriber hasn't tuned their subscription preferences they'll automatically be subscribed to any components. If a subscriber has already tuned their subscriptions, they will not automatically be added to new components.
Impact on existing subscribers
When enabling component subscriptions, existing subscribers will remain subscribed to all of the components that they normally receive notifications for, and will have the ability going forward to manage their subscriptions manually.
How users manage their subscription
The confirmation messages and all further communication to that subscriber will contain a link to the subscription management page.
As an admin, you will also have easy access to this page via the management portal and your subscriber list.
Unsubscribe from notifications
If a subscriber wants to unsubscribe or manage their subscription but does not have access to an existing message with a subscription management link, they can modify their subscription settings from the status page the same way they original subscribed.
Note: This only works if the page has component subscriptions enabled.
To do this, they need to go to the status page and click Subscribe, then input their email/phone number. We will recognize that they are already subscribed and they can manage their subscription settings on the next page.