Skip to main content
Creating a status page only takes about a minute. Before you do so, Rootly recommends you have at least one service configured in Rootly that you can display on your status page. You can do this by visiting Configuration > Services or if you have the PagerDuty integration configured, you can easily import services directly from PagerDuty then add them to your status page. To create a new status page:
  1. In the Rootly navigation bar, click on Configuration, then Status Pages.
  2. Next, click Add New Status Page.
  3. Give your status page a name and description. These are internal to Rootly, and will not be used on the actual Status Page.

​
Customize your Status Page

Once you’ve created your status page, you’re able to customize the look and feel of the page to tailor the contents to your end users.

​
Setup

Under setup, you’re able to make changes to the name and description of your status page. Remember: these are internal only so should be descriptive for other Rootly admins to know what the status page is. Here, you can also determine if the page will be private or publicly available. Learn more about public and private status pages. In the Advanced Settings, you can also customize the domain name of the status page. By default, Rootly will assign each Status Page a URL in the following format: rootly.com/teams/[your-org-name]/status-pages/[status-page-name]/[public/private] Configure your own custom domain by following: Custom Domain Names for Status Pages. Note: for custom external domain names, you may need to talk with the team at your organization to have them help you configure a custom domain name and associated DNS.  Setup Status Page

​
Customize

Customize the default content and look-and-feel of your status page in the Customize tab. As you make changes to the settings in this tab, the right-hand preview of your status page will reflect your latest updates. Customize Status Page

​
Components

Use the Components section to choose what appears under the ‘System Status’ section of your page. You can add three kinds of components:
  • Services — any Rootly service.
  • Functionalities — a functionality represents a higher-level, customer-facing capability (like “Login” or “Checkout”) that can be backed by many underlying services. Add a functionality when you want to show a single customer-facing component instead of a long list of internal services.
  • Third party services — any external service your organization depends on.
Functionalities are useful when you maintain a large number of services but only want to expose a small set of product components publicly. Map your services to a functionality on the functionality itself, then add only that functionality to the page. A component is shown as impacted under ‘System Status’ when an incident that is published to this status page is associated with that component. For a functionality, that means the incident is tagged with the functionality (or the component is selected when publishing the status page update). Associating a service with a functionality does not by itself change the functionality’s status. The status is always driven by the incident.
If you don’t see Functionalities as a component option, reach out to support to have the Functionalities field enabled for your organization.
To tag functionalities automatically, use a workflow that runs on incident create or update, conditions it on the severities and services you care about, and adds the matching functionality with the Update Incident action. Be aware that this action replaces the incident’s entire functionality list rather than adding to it, so it also clears any functionalities set earlier by another workflow or by hand. That reaches beyond the status page — a functionality dropped from an incident also stops driving its ownership, escalation policy, and notification settings for that incident. It is only safe when a single workflow run can determine the complete set of functionalities for the incident. If several workflows could tag different components on the same incident, select the affected components manually when you publish the update instead.
Note: You’ll be able to add third party services to your status page after you’ve created the status page. Status Page Component

​
Templates

Standardize the incident updates your teams share with Status Templates. When a commander publishes an incident update to a status page, they’ll be able to use the templates defined in this section to help write their update. Templates Status Page

​
Go-Live Checklist

Setup spans several pages. Work through this before you point customers at the page.

Pick the page type

Public or private — the choice drives everything below it. See Overview.

Add your components

Add the services, functionalities and third party services customers care about, and put them in the order you want them displayed. A page listing every internal service is harder to read than one listing a handful of customer-facing functionalities.

Write your templates

Templates are what a commander reaches for mid-incident. Writing them under pressure is how inconsistent updates happen.

Decide who can reach it

A private page is limited to people logged in to Rootly, and needs nothing further. A public page is reachable by anyone with the URL — if that is too open, add password or SAML authentication, which is available on public pages only.

Point your domain at it

Public pages usually want a custom domain. Both the CNAME and the CAA record are required, and DNS changes take time to propagate — do this before you need it, not during an incident.

Publish a test incident

Publish a low-severity incident, confirm it renders the way you expect, then resolve it. See Publishing Incidents.
If the test incident appears with the right components marked as impacted, the page is ready.