How to add a status page to your website, with your own domain
A status page is a separate page, not a section of your site, because it has to stay reachable when your site is not. Here is what to put on it, where to link it, and how to serve it from your own domain.
Updated
Short answer
Publish a status page built from your monitors, then link it from your site footer, help center and error pages. For an address like status.yourcompany.com, add the domain in the dashboard and create the CNAME and TXT records it lists. Custom domains need the Pro or Scale plan.
Publish your status page freeWhat a status page should show
Keep it to what a customer asks during an outage: is it down for everyone, and do you know about it.
| Show | Why |
|---|---|
| Current status per service | Group by what customers use, such as Website, API and Dashboard, not by server names |
| Uptime history | Lets a customer see whether today is unusual |
| Open incidents with updates | Tells them you are aware and what you are doing |
| Planned maintenance | Stops "is it broken?" tickets during work you scheduled |
| A way to follow updates | So they do not have to keep refreshing |
Do not show internal-only services. A page with fifty components is harder to read than one with five.
Where to link it
- Site footer. The standard spot. Label it "Status" so it is easy to find.
- Help center and support form. Customers who are already looking for answers see it before they file a ticket.
- App error screens. A 500 or "something went wrong" page can say "Check our status page" with a link.
- README or docs. A status badge links to the page; see the guide on GitHub README badges.
Use your own domain with a CNAME
By default a page lives at your-subdomain.status.uptimeio.com. On Pro and Scale you can serve it from a subdomain you own, for example status.yourcompany.com, and UptimeIO provisions the HTTPS certificate. Free plans keep the default address.
- Open Status Pages, select your page, then open the Custom Domain tab.
- Enter the domain in Domain, for example
status.yourcompany.com, and click Add Domain. Use a subdomain of a domain you control. - Click Verify DNS. The dashboard lists the exact records to create, usually a CNAME record that points your domain to UptimeIO and a TXT record that proves you own it. Use the copy button next to each value.
- Add both records at your DNS provider. Copy the host and value exactly as shown.
- Wait for DNS to update, then click Verify DNS again. The status changes from Pending verification to Verified, and the HTTPS certificate status appears next to it.
Once it is verified, the page header and the View button use your domain. To go back to the default address, click Remove on the same tab.
| Symptom | What to do |
|---|---|
| Stays on Pending verification | Check that both records match the dashboard values exactly, give DNS time to propagate, then click Verify DNS again |
| Message says the feature is not available | Custom domains need the Pro or Scale plan |
Do the DNS work in your provider's zone editor, not in your web host's page settings. If a record does not appear to take, the DNS Not Resolving guide covers how to check it.
Post incidents and maintenance
The page is built from your monitors, so a failing service shows up without anyone editing it. Two settings change how much you write by hand.
- Automatic incident publishing: in the Settings tab, UptimeIO posts incidents from your monitors to the page for you. You choose which severities to publish (critical, major, minor, warning). Defaults are critical and major, posted after a 60-second delay so brief flapping does not appear.
- Announcements: in the Announcements tab, write your own notices with a title and message. Types are Announcement, Warning, New and Update. Use Warning for planned work, with the time window in the message, and unpublish it afterward.
By default, time inside a scheduled maintenance window does not lower the uptime figure. Turn on Count scheduled maintenance as downtime if you want it counted.
Let customers follow updates
Every public page has a Subscribe menu with an RSS Feed and an Atom Feed that visitors can add to a feed reader.
Set it up in UptimeIO
- Click Status Pages, then Create Status Page, and choose a template.
- Enter a name and pick a subdomain. The subdomain is permanent once the page is created.
- Select at least one monitor, and give each a public name and a group.
- Set the theme and primary color, then click Publish, or Save as draft.
- Link the page from your footer, help center and error screens.
- Plans: Free includes 1 status page, Pro 20 and Scale 100.
- Branding: colors and text are available on every plan. Logo, favicon and custom CSS need Pro or Scale. Scale removes the UptimeIO branding.
- Privacy: password protection is on Pro and Scale, and you can ask search engines not to index the page.
- Visibility: only published pages are visible to visitors.
Questions
- How do I add a status page to my website?
- Create a status page from your monitors, publish it, and link it from your footer, help center and error pages. For an address on your own domain, add a custom domain and create the CNAME and TXT records the dashboard shows.
- Can I host a status page at status.mycompany.com?
- Yes, on Pro and Scale. Add the domain in the Custom Domain tab, create the DNS records it lists, usually a CNAME and a TXT record, and click Verify DNS. UptimeIO provisions the HTTPS certificate.
- Does the Free plan include a status page?
- Yes, one status page, at an address under status.uptimeio.com. A custom domain needs Pro or Scale.
- Can I change the subdomain later?
- No. The subdomain is permanent once the page is created. Use a custom domain on Pro or Scale if you want an address you control.
- Should the status page be on the same server as my website?
- No. If it shares a failure point with your site, it goes down with it. A hosted status page on a separate domain or subdomain stays reachable during your outage.
Related
- Status pages - What UptimeIO status pages include and which plans have them.
- Custom domain setup - DNS records and verification, step by step.
- GitHub README uptime badge - Show live status in a README and link it to your page.
- DNS not resolving - Check a record that does not seem to take effect.
- Pricing - Plan limits and prices.