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 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.

LayoutBest for
classicThe default. A prominent hero banner with the overall state, followed by the service list.
cardsEach service rendered as a card in a responsive grid.
minimalStripped-back, text-first presentation with minimal chrome.
sleekA modern hero banner with an accent-color gradient.
boardA dashboard-style board to see many services at a glance.
splitA full-width header with a two-column body (status next to history).
timelineEmphasizes a chronological timeline of incidents and maintenance.
compactDense layout that fits many services into little vertical space.

Appearance

OptionValuesDefaultDescription
colorSchemelight, dark, autoautoauto follows the visitor's system preference.
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.

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. 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