Set up a white-label status page for each client

Your client can open a page with their own logo and colors and see their sites, without writing to you to ask whether something is down. This guide sets that up for one client. You'll group the client's sites, build a status page that lists only those sites, brand it and publish it. Repeat it for each client.

What you need

• A role of Member, Admin or Owner in the workspace. Members can create and edit status pages.
• The client's sites already monitored in OctoPing. Heartbeats work the same way as sites.
• The client's logo as a PNG, JPEG, SVG or WebP file of up to 2MB, and their brand colors as hex values such as #0D9488.

Build the client's page

1. 1. Create a group for the client

   Open Websites and choose Manage Groups. Type the client's name in the New group name field and choose Add. A group is a heading in your websites list, so it keeps one client's sites together.

2. 2. Move the client's sites into the group

   Tick the checkbox beside each of the client's sites. A bar appears with Move to group, Enable, Disable, Check interval and Delete. Choose Move to group, then pick the client. The group header shows how many sites it holds.

3. 3. Create the status page

   Open Status Pages and choose Create Status Page. Name is for you, so use something like Northwind Dental status. URL Slug becomes the page's address, octoping.com/status/your-slug, and takes lowercase letters, numbers and hyphens. Page Title and Description are what the client's visitors read, and Company Website URL becomes the Visit website link in the page footer. Choose Create Status Page. The page starts as a Draft.

4. 4. Add the client's sites to the page

   On the page's detail screen, under Monitored Items, choose Add Item. Leave Type on Website, pick a site from the list and give it a Display Name such as Main site or Booking. The display name is what visitors see in place of the address. Repeat for each site, and choose Heartbeat as the type to show a scheduled job too.The group doesn't fill the page for you. A status page lists exactly the items you add to it, so the page for one client never shows another client's sites.

5. 5. Add the client's logo and colors

   Scroll to the settings below the incidents card. Under Branding, choose a file for Logo, and one for Header Image if you want a banner. Under Style & Appearance, enter the Primary Color and Secondary Color, and choose a Font, a Border Radius, a Badge Style and a Header Style. Three switches decide what each item shows: Show Uptime Percentage, Show Response Time and Show 90-Day Status Chart. Choose Save Settings, then Preview to look at the page before anyone else does.

6. 6. Publish the page

   Switch Draft to Published at the top right of the page. The badge changes to Published and a View Public Page button appears. The address is live once the switch is on.

Verify it works

Open the page's address in a private browser window, where you aren't signed in. You should see this.

• The Page Title and Description you wrote, and the client's logo.
• An overall banner, which reads All Systems Operational while every item is up.
• One row for each item you added, under its Display Name, with its uptime over the last 90 days.
• Only that client's items. If another client's site appears, remove it from the Monitored Items list.

Switch the page back to Draft and reload the address in the private window. Visitors get a not-found page until you publish it again. OctoPing keeps a copy of a public page for 60 seconds, so the change can take that long to show.

Serve the page on the client's own domain

On a paid plan you can show the page at the client's hostname, such as status.client.com, instead of an octoping.com address. An Owner or Admin sets it up, because the Custom Domain card on the page's detail screen is shown to those roles. A trial workspace sees a note that custom domains need a paid plan.

• Enter the hostname in the Custom Domain card and choose Save. OctoPing shows the DNS record to add.
• Create that CNAME record at the client's DNS provider. The value is unique to this page. On Cloudflare, set the record to DNS only and not proxied.
• Choose Verify DNS. The status reads Waiting for DNS, then Issuing certificate, then Live. DNS changes can take up to 48 hours to reach everyone.

This guide describes the setup without running it, because it needs a paid plan and a domain we can change. The status pages feature explains what the hostname serves once it's live.