Branding and themes
Upload a logo, choose light, dark or auto, and understand exactly which customisation options exist today and which do not.
A status page is one of the most-visited pages you own during an outage. It should look like it belongs to you. This page covers what you can change today — and is explicit about what you cannot, because two of the fields in the underlying data model have no editor behind them.
Logo
- Open the status page → Settings → Branding.
- Click Upload logo and pick a file.
- The file is stored on StatusOwl's CDN and appears at the top of the page on the next load.
Constraints:
- Formats: PNG, JPEG, GIF and WebP.
- Not accepted: SVG. The upload is checked by inspecting the file's actual bytes, not its extension, so renaming an SVG will not get it through. This is deliberate — SVG can carry script, and the page renders on your own domain.
Uploading a replacement removes the previous file. Remove logo falls back to a text-only header.
Theme
Three modes, set per page:
| Mode | Behaviour |
|---|---|
| Light | Always light. |
| Dark | Always dark. |
| Auto | Follows the visitor's prefers-color-scheme. |
Whichever you choose is the page's default, not a lock: visitors get their own theme toggle and their choice is remembered in their browser. A small pre-paint script applies the stored preference before the first frame, so there is no white flash on a dark-mode load.
If your audience is mixed, Auto behaves the way most people expect. Pick Light or Dark only when you have a brand reason to override the system preference — and remember the visitor can override you back.
What the page shows
Three per-page display toggles, independent of theme:
- Uptime bars — 90 days of daily uptime per service.
- Response times — latest response time under each service.
- Incident history — resolved incidents below the current state.
See Uptime history.
Custom domain
Serving the page from status.yourcompany.com does more for it looking like
yours than any amount of styling. It is available on every plan, including
Free. See Custom domains.
Not available yet
Three things you may be looking for, stated plainly rather than left to be discovered:
Custom CSS, custom header and footer HTML. The renderer supports and sanitises all three, and the fields exist in the data model — but there is no editor in the dashboard, so there is no way to set them. This is on the roadmap. Any documentation you may have seen describing a Custom CSS box in Settings was wrong.
Per-page favicon. There is a favicon URL field and it round-trips through the API, but it is never applied to the rendered page. Every status page shows the StatusOwl owl in the browser tab today.
Password-protected pages. Private means the page returns a 404, not that it prompts for a password. See Private pages.
See also
- Create a status page — subdomain, switches and display toggles.
- Custom domains — your own hostname with automatic SSL.
- Private pages — what private actually does.