Skip to Content
Uptimeify Docs
Status pages

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 nine 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. The design editor shows each layout under the name in the first column; the API and MCP use the value in the second.

Layout (design editor)API valueBest for
ClassicclassicA prominent hero banner with the overall state, followed by the service list.
CardscardsEach service rendered as a card in a responsive grid.
MinimalminimalStripped-back, text-first presentation with minimal chrome.
SleeksleekA modern hero banner with an accent-color gradient.
BoardboardA dashboard-style board to see many services at a glance.
SplitsplitA full-width header with a two-column body (status next to history).
TimelinetimelineEmphasizes a chronological timeline of incidents and maintenance.
CompactcompactDense layout that fits many services into little vertical space.
StatusboardstatusboardThe default for every page without its own layout. Uptime bars per service across the whole history window, like a classic status board.

Screenshots

All screenshots show the same demo page in the light color scheme, otherwise with default settings, 1280 x 900 px.

Classic (classic)

Status page in the Classic layout

Cards (cards)

Status page in the Cards layout

Minimal (minimal)

Status page in the Minimal layout

Sleek (sleek)

Status page in the Sleek layout

Board (board)

Status page in the Board layout

Split (split)

Status page in the Split layout

Timeline (timeline)

Status page in the Timeline layout

Compact (compact)

Status page in the Compact layout

Statusboard (statusboard)

Status page in the Statusboard layout

Appearance

OptionValuesDefaultDescription
colorSchemelight, dark, autoautoauto currently renders like light.
accentColorhex color #rrggbb#6366f1Used for highlights, links, and gradients.
headerStylesimple, centered, herosimpleHow prominent the page header is.
fontFamilysystem, monosystemmono gives a technical, monospaced look.
cardRadiusnone, md, xlmdCorner rounding of cards and panels.
pageWidthsm, md, lg, xllgMaximum content width.

Content & sections

OptionTypeDefaultDescription
customTitlestring (≤120)-Overrides the page title in the header.
customSubtitlestring (≤200)-A subtitle shown under the title.
showUptimeStatsbooleantrueShow per-service uptime percentages.
showServiceUrlsbooleanfalseShow each service's URL next to its name.
showLastCheckedbooleanfalseShow the "last checked" timestamp per service.
showHistorybooleantrueShow the recent history section.
historyDaysnumber-How many days of history to include (bounded by the platform min/max).
showPoweredBybooleantrueShow a "Powered by <your product name>" line in the footer. It names you, never Uptimeify: with no product name set, the line is not rendered at all.

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.

Custom CSS

Under Design → Custom CSS (API field customCss) you can add your own CSS, up to 20 KB. It is applied on the public page only, not in the design preview and not in the embed widget, and it only reaches the page content: the footer with your legal links and the subscribe dialog stay as they are. To keep visitors safe, nothing in it may load a resource: url(), @import, @font-face and similar are rejected when you save, with a message saying what was not allowed. All rules: Update Status Page Design.

Badge and embed widget

Every public, published page has two embeddable views, also on your custom domain:

URLWhat it is
/status/<slug>/badge.svgStatus badge (SVG) with the overall state, for a README or a website. ?lang=de or ?lang=da for another language.
/status/<slug>/embedCompact widget for an <iframe>: overall state, open incidents, a link to the page. No script. ?lang= as above, ?theme=light or ?theme=dark (default: the page's color scheme).

The design page has copy-ready snippets for both. Both are cached for 60 seconds. For a password-protected or members-only page, an unpublished page or a page whose module is off they answer 404, so a badge never reveals the state of a page that is not public.

White-labeling

A status page never names Uptimeify. The footer's copyright line names the operator of the page (your product name, or the status page's own name if you have not set one), and if neither exists, no copyright line is rendered. Nothing on the page falls back to the vendor's name. White-labeling is not a plan feature; it applies on every paid plan.

For a fully branded page:

  1. Set your product name under Branding. It is what the copyright line and the "Powered by" line say, and it is the only thing either of them will ever say.
  2. Configure a custom domain so the page runs on your hostname.
  3. Upload a favicon under Branding. On your own domain this is what visitors see in the browser tab and on an iOS home screen. Without one the page carries no icon at all, it will never carry Uptimeify's.
  4. Upload a logo under Branding. It appears at the top of the page in every layout. With a light and a dark variant, the page picks the one matching its own color scheme (auto counts as light). The alt text is your product name, or the status page's name if you have not set one. Disable custom logos under Branding removes it again.
  5. Set an accentColor (and optionally customTitle/customSubtitle) that matches your brand.

showPoweredBy is a separate choice: leave it on to credit your own product in the footer, turn it off for no attribution line at all.

On this page