Two Ways to Start
- Create a new page: Start from scratch and build your page in Rootly. Follow the steps below.
- Import from Atlassian Statuspage: Bring your existing pages, components, subscribers, and incident history over through the API. See Importing from Atlassian Statuspage.
Create a New Page
Creating a status page usually takes between 2 and 10 minutes, depending on how much you set up. Before you start, have at least one service configured in Rootly that you can show on your page. You can add services under Configuration → Services, or import them from PagerDuty if you have that integration set up. To create a new status page:1
Open Status Pages
In the Rootly navigation bar, click Configuration, then Status Pages.
2
Add a New Page
Click Add New Status Page.
3
Choose a Page Type
Pick Internal, Public, or Customer, then click Continue. Not sure which to pick? See Internal, Public, or Customer?
4
Name the Page
Give your status page a name and description. These are internal to Rootly, and will not be used on the actual Status Page.
Every organization includes 2 free published status pages. Unpublished pages don’t count toward the limit, so you can build a page before it goes live. See Free Status Pages.
Customize Your Status Page
Once you’ve created your page, open it and click Edit to tailor it to your audience. The editor has these tabs: General, Authentication, Customize, Components, Templates, and Terraform. A live preview on the right updates as you make changes.General
Change the name and description of your status page here. These are internal only, so make them descriptive for other Rootly admins. You can also choose whether the page is internal, public, or customer. Learn more about status page types. By default, Rootly gives each status page a URL in this format:rootly.com/teams/[your-org-name]/status-pages/[status-page-name]/[public/private]
To use your own domain, follow Custom Domain Names for Status Pages. You may need help from your team to configure the domain and its DNS records.
Customize
Change the default content and look and feel of your page in the Customize tab. The preview on the right reflects your changes as you make them.
Components
Use the Components tab to choose what appears under System Status on your page. Add catalog services or custom items, then organize them into groups.
Templates
Standardize the updates your team shares with status templates. When someone posts an incident update, they can pick a template to help write it. To share templates across every page, use global templates.
Go-Live Checklist
Setup spans several pages. Work through this before you point customers at the page.Pick the Page Type
Internal, public, or customer. The choice drives everything below it. See the Status Pages overview.
Add Your Components
Add the catalog services and custom items customers care about. A page with a handful of customer-facing components is easier to read than one listing every internal service.
3
Group and order them
Put related components in groups and drag them into the order customers should see.
Write Your Templates
Templates are what responders reach for mid-incident. Writing them under pressure is how inconsistent updates happen.
Decide Who Can Reach It
An internal page is limited to people in your Rootly organization. A public page is reachable by anyone with the URL. If that’s too open, use a customer page, which requires viewers to sign in with a password or SSO. See authentication. To control which of your teams can edit or post to the page, see Roles and Permissions.
Point Your Domain at It
Public and customer pages usually want a custom domain. Both the CNAME and CAA records are required, and DNS changes take time, so do this before you need it.
Post a test incident
Post a low-severity incident, check that it looks the way you expect, then resolve it. See Publishing Updates.
If the test incident shows up with the right components and impact levels, the page is ready.
Related Pages
Components
Communicate the status business entity your customers care about with Components.
Custom Domain Names
Point your own domain at a Rootly status page with CNAME + CAA records.
Publishing Incidents
How incident updates get pushed to a status page from Web or Slack.
Customer Pages
Share service health with specific customers, behind a login.
Roles and Permissions
Choose which teams can edit a page and which can only publish to it.
Free Status Pages and Limits
What’s included, and what to do when you reach the limit.