Customizing a Status Page
Status pages support a primary brand color and a choice of layout. Both are set on the Create and Edit screens and apply to the public page at /status/{slug}.
Primary color
The primary color is your main brand color. It is applied to the public page as the --primary-color CSS variable.
- Set it with the color picker on the create/edit form.
- Default:
#10b981(emerald green). - Accepts a hex value (
#RGB,#RRGGBB, or with alpha). Invalid values fall back to the default#10b981.
Layout
The layout controls the overall visual style of the page. Each style ships in a light and a dark variant, selected from a single dropdown:
| Layout value | Style | Mode |
|---|---|---|
modern-light |
Modern | Light (default) |
modern-dark |
Modern | Dark |
classic-light |
Classic | Light |
classic-dark |
Classic | Dark |
compact-light |
Compact | Light |
compact-dark |
Compact | Dark |
How it renders:
- The page body gets a
layout-<style>class (layout-modern,layout-classic, orlayout-compact). - Any
-darkvariant additionally loads the dark theme stylesheet and adds thedark-modeclass. - The default when nothing is set is
modern-light.
Language
A status page can render in a specific locale. Set the language on the create/edit form; the public page uses that locale for its labels (status text, "Uptime history", "Recent incidents", date formats, etc.). Defaults to en.
What appears on the page
The public page is composed of these sections, in order:
- Status hero β title, description, and the overall status banner ("All systems operational" or "Experiencing issues") with a last-updated timestamp.
- Uptime history β a per-day grid colored by uptime (excellent β₯ 99.9%, good β₯ 95%, poor below 95%, plus a "no data" state). See Uptime History.
- Services β assigned monitors grouped by their monitor group. Each shows its current status and, where available, latest response time. A group is marked "partial outage" if any of its monitors is down.
- Recent incidents β up to the latest incidents for the assigned monitors, with start time and (if resolved) the resolution duration.
Title and description
- Title appears in the hero and the page
<title>. - Description appears under the title and is used as the page meta description for SEO and link previews. It is optional.
What is not configurable
The status page builder exposes the primary color, layout, language, history window, public/private flag, and monitor selection. Per-page custom CSS/HTML and logo/favicon overrides are not exposed in the status page editor β use the primary color and layout options for branding, and a custom domain for hostname branding.
Next Steps
- Custom Domains - Serve from your own hostname
- Uptime History - Configure the history window
- Setup - Assign monitors to the page
- Overview - Public vs. private and plan limits