Setup Instructions for your Status Page

These setup instructions will cover all three varieties of Status Page. This document will sometimes refer to a “Status Page”, which should be taken as a generic term to apply to all types of status pages unless otherwise noted. You can find specific use cases and information for each Status Page type here.

To skip to a specific section of the " Status Page Solution: Basic Setup" video, click the links with the youtube-logo-final.svg!

Table of Contents

Creating a Status Page


youtube-logo-final.svg Skip to 0:15

Status Pages.png

The following sections will walk through Page features and the creation of your first Page (including components, groups, metrics, adding your first incident, and scheduling maintenance).

To create your first page, click Status Pages, select the Status Page type, and then click New Status Page. There are three Status Page types you can choose from:

Using the Public Status Page screen as an example, you can see and manage your status pages through the Actions buttons Edit, Add Incident, and Schedule Maintenance.


For additional settings like Duplicate or Delete, click the "three dots" button at the far right.

Viewing Your Page



Once a Page is created, with or without components, it is viewable if you click the eye-icon.pngat the top right-hand side. You will notice both Current Status and History & Incidents tabs are enabled by default for the Public Status Page and Internal Status Page, but not for Public SLA (where only History & Incidents is enabled by default).

Managing your Page


To edit or change your Page, click the Status Page type and locate the Page you wish to manage. Click Actions > Manage, and you will have access to the Page settings below.

Status Page Settings


youtube-logo-final.svg Skip to 0:55

SP settings.png

Use these settings to determine what your visitors will see, what they can click, and the detail level of reporting on your page. Click settings-cog.png and then select your option:

Please use the included links to learn more about the forms available for each setting. 

Global Settings


Determine whether your Page will be displayed publicly, set your URL slug, CNAME, or configure Basic Auth. 

Your Status Page is required to have a name, but the description is optional. The text placed inside these fields will appear in the default header of your Status Page. If you use inline HTML and CSS, it is possible to replace or override this text. 



You are able to set the timezone for the Status Page to control the information that is presented on the external status page from the timezone set. You can also set the time format to be 12H or 24H. This setting will be reflected when viewing any created Status Page events.

Please Note: The maintenance and incidents data you will see are not affected by the timezone change, on the Status Page setup.
However, the change will be visible once you view the status page live and also your external users will also be able to see the change.


Creating a Custom Subdomain for Your Status Page


 Any account tier can create a custom subdomain for your Status Page. To begin, manage a status page’s settings and navigate to the CNAME field. Enter a custom subdomain to host your status page (for example:


Next, create a CNAME record for the subdomain you are trying to create. Point this record to “”.


Configuring CAA (Certification Authority Authorization) Records for Status Pages

For information about configuring CAA records in conjunction with Status Pages, please see the dedicated document located here.


Current Status


youtube-logo-final.svg Skip to 8:45


The Current Status tab tells visitors what is happening in real time. Current Status includes multiple sections such as Active Incidents, Components (and status), and Scheduled Maintenance. You can control visibility of these sections when you manage your Status Page

History & Incidents


The History & Incidents tab sums up past outages, scheduled maintenance windows, and allows visitors to browse these events with date selection. You can set a default date range, or determine the method to calculate uptime; the duration of incidents or the uptime percent of check-based components.

As an account owner or admin, you have the option to enforce the date/time range by using the Maximum Selectable Time Range (days) option.

This option defines the widest range of time users can select or view on the date picker on the Status Page.If the range is empty, all data is shown.


Please Note: This option is only available when switching the Status Page view to the NewGen UI.


Look & Feel


youtube-logo-final.svg Skip to 10:10


Use Look & Feel to add a logo to your Page, or customize the Inline CSS/HTML placed in your header and footer. Users can also add their Google Property/Measurement ID here, and set a contact email address where visitors can report a problem not listed on the page. 

Please Note: The CSS and HTML feature is dependent on the plan you are on.

Customizing Emails


You can customize the look and feel of the notification emails sent to subscribers of your Page, including the Send From email address used.

Note: Customizing the Send From email address will require DNS changes for your domain. Please see the changing your SPF record document for more information on how to accomplish this.

Subscription Management


View List Of Subscribers


From the status page header panel, there is an option to view the current Subscribers of the status page.

On the page, the list of subscribers will be present and shown in an alphabetic list by the email. There is an option to either select each subscriber individually, or bulk select them.

View list.png

If you do not have any current subscribers on the page you will see the message: You don’t have any subscribers for your status page yet.




From the same page, you are able to Import your subscribers list from the chosen file format specified and Export the subscribers list in the form of an Excel file. 



When selecting Import, a pop up screen will appear, where it will show the amount of current subscribers, an option to download the current subscriber list, and the option of importing the subscribers file.


import subscribers.png

Selecting the Export option will download the list of subscribers, similar to the functionality of downloading the subscribers list, found in the Import section.


Search & Delete


Under the Subscribers tab, there will also be an option to search for current subscribers to your status page from the search box. You can also delete specific subscribers by selecting the bin icon. 


You also have the option to bulk delete the subscribers by checking the box next to each subscriber to be deleted.

delete users.png


Subscribing with a Custom Webhook


Uptime Custom Webhooks offer the option to send notifications to a URL of your choice when an event occurs, allowing for seamless status tracking.

By implementing Uptime Custom Webhooks, real-time alerts can be sent to systems via HTTP POST in a JSON serialized string. These notifications will help subscribers stay informed of any changes in the check status, such as UP to DOWN or vice versa, and take timely action accordingly..

To review an example of the POST request, please click here.




youtube-logo-final.svg Skip to 2:47

Components represent the core of your page. You can add up to 200 components, each with an optional description. 

If you wish to add a component to an existing page, click + Add Component or + Add Group to add a Component Group

Component Add Group.png


If you Add or Edit a Component, you can associate it with a check. Type the check name or URL, and select it from the dropdown menu. You can then set the state of this check to change automatically when failure conditions are met. 


Component Status


To change a component’s status manually, select the status from the dropdown menu within the Components tab of your page. 


To automate a change in status, you must do at least one of the following:

  • Link a component to a check (Requires setting a status on check failure)
  • Add an incident that affects a component or group linked to a check
  • Schedule a maintenance window that affects a component or group linked to a check

A change in status, whether manual or automated, is reflected simultaneously live on your page for a given component.

Components always inherit the most severe status, therefore it is possible to manually override an automated change in status if the manual status is more severe. For more information on how this works, see this section on Component Status.

Component-Specific Subscriptions


Your users have control over the components they receive incident or maintenance update notifications for.  Once subscribing to your status page, the user can choose which specific components interest them and select them accordingly. 

 By default, all components are selected, but users can fully customize the notifications they receive based on their preferences. 

Once submitted, users will receive an email confirmation, as shown below. From that email, users can unsubscribe or manage their subscriptions at will.

System Metrics



You may add up to 10 system metrics, and customize their names. 

Select + Add System Metrics to display a selected component’s metrics on your Status Page. System metrics are visible if you have enabled Display "Current Status" tab on your Status Page (in Settings > “Current Status” tab).

Incidents & Maintenance



Incidents and maintenance windows help inform users of scheduled maintenance windows and downtime events (whether standalone incidents or as a byproduct of maintenance operations).

Add incidents and notify visitors of scheduled maintenance windows by clicking + Add Incident or + Add Scheduled Maintenance under their respective navigation tabs. Follow the links for more information on setting up and managing Incidents and Scheduled Maintenance.

Sharing a Status Page


It is possible to share your Page through a variety of methods. Firstly, by making your Page public and sharing the URL. You can also enable subscriptions and search indexing.

Users can:

  • Make a publicly accessible Page that is or is not search engine indexable
  • Create a custom URL Slug and/or Custom CNAME
  • Use Basic Auth to restrict access to users without the username and password
  • Allow external users to access via Single Sign-on (SSO) or a status-page specific login.


Basic Auth


To keep your Page visible only to a select group, utilize the Basic Authentication feature and set a username and password to be used for access to your Page. Set all accessibility parameters by clicking settings-cog.png>Settings

Single Sign-On (SSO) and External Users

For accounts with SSO enabled, Status Pages can be secured via SSO and an external Identity Provider (IdP) or via external user logins with the portal.

For detailed instructions, see our article Securing Your Status Page.

Configuring CAA (Certification Authority Authorization) Records for Status Pages

For information about configuring CAA records in conjunction with Status Pages, please see the dedicated document located here.


Want to see our checks in action? Check out our youtube-logo-final.svg YouTube Library for more!

Was this article helpful?
4 out of 5 found this helpful



Article is closed for comments.

Have more questions?
Submit a request
Share it, if you like it.