Design & Branding

Every status page has a visual design configuration. Edit it in the app under Dashboard → Status Pages → (page) → Design, or via the design API. Changes are merged — you only send the fields you want to change, and the rest keep their current values.

Layouts

Choose one of eight layout presets. They all show the same data (overall state, services, optional stats and history) but differ in structure and density — preview each one live in the design editor.

Layout	Best for
`classic`	The default. A prominent hero banner with the overall state, followed by the service list.
`cards`	Each service rendered as a card in a responsive grid.
`minimal`	Stripped-back, text-first presentation with minimal chrome.
`sleek`	A modern hero banner with an accent-color gradient.
`board`	A dashboard-style board to see many services at a glance.
`split`	A full-width header with a two-column body (status next to history).
`timeline`	Emphasizes a chronological timeline of incidents and maintenance.
`compact`	Dense layout that fits many services into little vertical space.

Appearance

Option	Values	Default	Description
`colorScheme`	`light`, `dark`, `auto`	`auto`	`auto` follows the visitor's system preference.
`accentColor`	hex color `#rrggbb`	`#6366f1`	Used for highlights, links, and gradients.
`headerStyle`	`simple`, `centered`, `hero`	`simple`	How prominent the page header is.
`fontFamily`	`system`, `mono`	`system`	`mono` gives a technical, monospaced look.
`cardRadius`	`none`, `md`, `xl`	`md`	Corner rounding of cards and panels.
`pageWidth`	`sm`, `md`, `lg`, `xl`	`lg`	Maximum content width.

Content & sections

Option	Type	Default	Description
`customTitle`	string (≤120)	—	Overrides the page title in the header.
`customSubtitle`	string (≤200)	—	A subtitle shown under the title.
`showUptimeStats`	boolean	`true`	Show per-service uptime percentages.
`showServiceUrls`	boolean	`false`	Show each service's URL next to its name.
`showLastChecked`	boolean	`false`	Show the "last checked" timestamp per service.
`showHistory`	boolean	`true`	Show the recent history section.
`historyDays`	number	—	How many days of history to include (bounded by the platform min/max).
`showPoweredBy`	boolean	`true`	Show the "powered by Uptimeify" footer. Turn off for full white-labeling.

showHistory controls whether the history section is rendered. The separate Show recent incidents and Show recent maintenance toggles (on the page's main settings) control what goes into that section. See Recent history.

Example (API)

curl -X PATCH "$BASE_URL/api/status-pages/<id>/design" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "layout": "sleek",
    "colorScheme": "dark",
    "accentColor": "#10b981",
    "showServiceUrls": true,
    "showPoweredBy": false
  }'

Only the fields you send are changed; everything else keeps its current value. See Update Status Page Design for the full reference.

White-labeling

For a fully branded page with no Uptimeify references:

Set showPoweredBy to false.
Configure a custom domain so the page runs on your hostname.
Set an accentColor (and optionally customTitle/customSubtitle) that matches your brand.