Skip to content
Browse docs
Docs / Uptime monitoring / Status pages: a public page for your uptime

Status pages: a public page for your uptime

A status page is a public page that shows your customers whether your website, API and services are up, with 90 days of history, your incident updates and planned maintenance. It updates itself from your uptime monitors, and anyone with the link can open it without signing in.

A public status page titled Monity demo status: All systems operational, a Get updates button, the scheduled maintenance for the coming week, and each service with its status, 90 daily bars and its 90-day uptime

Create a status page

  1. Open the Status pages card

    On the Uptime page, find Status pages on the right and click New status page.

    The Status pages card on the Uptime page listing Monity demo status, its address and 5 monitors, with a copy-link button and a New status page button
  2. Name it and choose its address

    Enter a Title, such as “Acme status”. The Address is app.monity.ai/status/ followed by letters, digits and dashes; leave it empty to make one from the title. An optional Description appears under the title.

  3. Add your branding

    Paste the address of your Logo (an https image) and pick an Accent colour, used for the page’s Get updates button.

  4. Pick the monitors to show

    Under Monitors on the page, tick the services your customers care about. Visitors see each monitor’s name, so name them for customers (“Checkout”, “API”, “Email”). If a ticked monitor is still named after its address, the dialog warns you and offers Rename it.

    The Edit status page dialog: title, address, description, logo and accent colour, the monitors on the page with a warning on one named after its address, and the switches for showing incidents and publishing
  5. Create it

    Leave Show the last two weeks’ incidents on to list recent outages, then click Create page. Copy the link from the card and put it in your site’s footer, help centre or emails.

An account can have up to 20 status pages, for example one per product or per client. Admins and editors can create and change them.

What visitors see

  • The headline: All systems operational only when every monitor on the page answered up. Otherwise Some systems are down, Major outage, Scheduled maintenance in progress or Some systems are not reporting.
  • Your news: open incident and maintenance posts with their updates.
  • Scheduled maintenance in the next 7 days, with the monitors it affects.
  • Each monitor: Operational, Down, Maintenance or No data (a monitor out of credits or without a recent result), with a bar for each of the last 90 days and its 90-day uptime.
  • History: resolved posts of the last 14 days and, if you chose, the last two weeks’ incidents with their start and duration.

Visitors never see the address a monitor checks, its errors or its response times. The page refreshes every minute.

The foot of a status page: a resolved post with its last update, and past incidents listing each outage with its start and how long it lasted

Post an incident or maintenance

The monitors show what is down. Posts say what you know and what you are doing about it.

  1. Open News and updates

    In the Status pages card, click ⋮ next to the page and choose News and updates.

    The menu of a status page: Open, News and updates, Edit, Copy badge and Delete
  2. Write the post

    Click Post an incident or maintenance. Enter a Title, choose the Impact (Minor, Major or Maintenance) and the Status (Investigating, Identified, Monitoring or Resolved), and write the Message. Tick Email it to subscribers to send it to everyone who subscribed. Click Post.

    The News dialog with a new post being written: title, impact Minor, status Investigating, a message and Email it to subscribers ticked, above an earlier post with its updates and an Add an update button
  3. Update it until it is resolved

    Click Add an update under the post, choose the new status and say what changed. A post set to Resolved moves to the page’s history.

While a post is open, the page’s headline is at least as serious as its impact: Major shows Major outage, Minor shows Some systems are down and Maintenance shows Scheduled maintenance in progress. A post never makes the headline look better than the monitors.

The top of the status page while a major post is open: a red Major outage headline and the post Checkout errors for some customers with its Identified and Investigating updates

To show planned work without writing a post, schedule a maintenance window: the page lists it for the week before.

Email subscribers

Visitors click Get updates on the page and enter their email address. They get a confirmation email first, and nothing else until they click it. After that they receive the posts and updates you send with Email it to subscribers, each with a one-click unsubscribe link. Subscribers are not emailed automatically when a monitor goes down or comes back: only your posts reach them. The News dialog shows how many confirmed subscribers a page has, up to 20,000 per page.

The status page header after clicking Get updates: an email address typed in and a Subscribe button

Status badges

Click ⋮ next to a page and choose Copy badge to copy Markdown for a badge that shows the page’s state live, for a README or a footer. For one monitor’s 90-day uptime, add ?monitor= and the monitor’s name to the badge’s address:

https://api.monity.ai/uptime/status/<your-page>/badge.svg
https://api.monity.ai/uptime/status/<your-page>/badge.svg?monitor=Checkout%20API
Two badges: status operational for the whole page, and Checkout API with its 90-day uptime percentage
Your own domain

When your account offers a custom domain, the dialog shows a Your own domain field. Enter a host name such as status.example.com, save, and add the CNAME record the dialog then shows at your DNS provider. Without that field, share the page’s app.monity.ai/status/ address.

Hide or delete a page

To take a page offline for a while, open Edit and switch off Published: the card marks it Hidden and its link stops working until you publish it again. Delete removes the page and its link for good; the monitors are not affected. Changing the Address also breaks links to the old one, and the badge.

Kamil, Alex and Martyna Median reply under 6 hours

Have a question?

Pricing, security, or scoping - pick a route and you will land in a real person's inbox.