Back to Documentation

Status Page Setup Guide

Create public status pages to keep your users informed about the health and availability of your services in real-time.

What are Status Pages?

Status pages are public-facing web pages that display the real-time health and uptime of your services. They help you communicate service status to your users, build trust through transparency, and reduce support requests during incidents.

Real-time Status

Display live status of all your monitors with automatic updates when issues occur.

Custom Branding

Customize colors, logos, and domains to match your brand identity.

Uptime History

Show historical uptime data and incident timeline to build user confidence.

User Trust

Proactively communicate with users, reducing support tickets during outages.

Quick Start

1

Navigate to Status Pages

Go to the Status Pages section from your dashboard sidebar.

2

Create New Status Page

Click the 'Create Status Page' button to open the creation dialog.

3

Configure General Settings

Enter a name for your status page and customize the URL slug.

Name: e.g., "Acme Corp Status"

Slug: e.g., "acme-corp" (becomes /status/acme-corp)

Description: Brief description of what services are monitored

4

Select Monitors

Choose which monitors to display on your status page. You need at least one monitor.

Don't have monitors yet? Create a monitor first

5

Customize Branding

Set your brand colors and optionally add a logo URL.

Primary Color
Background
Text Color

Publish Your Page

Toggle "Published" to make your status page publicly accessible, then click Create!

Configuration Reference

FieldRequiredDescription
nameYesDisplay name for your status page (max 100 chars)
slugYesURL-friendly identifier (lowercase, numbers, hyphens only)
descriptionNoBrief description shown on the status page (max 500 chars)
customDomainNoCustom domain like status.example.com (Pro plan)
publishedNoWhether the page is publicly accessible (default: false)

API Reference

Create Status Page via API
Programmatically create and manage status pages using the REST API.

Endpoint

POST /api/status-pages

Request Body

{
  "name": "Acme Corp Status",
  "slug": "acme-corp",
  "description": "Real-time status of Acme Corp services",
  "monitors": ["monitor-id-1", "monitor-id-2"],
  "published": true,
  "theme": {
    "primaryColor": "#3b82f6",
    "backgroundColor": "#0a0a0a",
    "textColor": "#fafafa"
  },
  "logoUrl": "https://example.com/logo.png",
  "customDomain": "status.acme.com"
}

cURL Example

curl -X POST https://wakestack.co.uk/api/status-pages \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "name": "My Status Page",
    "slug": "my-status",
    "monitors": ["monitor-id"],
    "published": true,
    "theme": {
      "primaryColor": "#22c55e",
      "backgroundColor": "#0a0a0a",
      "textColor": "#fafafa"
    }
  }'

Response

{
  "id": "sp_abc123",
  "name": "My Status Page",
  "slug": "my-status",
  "description": null,
  "monitors": ["monitor-id"],
  "published": true,
  "theme": {
    "primaryColor": "#22c55e",
    "backgroundColor": "#0a0a0a",
    "textColor": "#fafafa"
  },
  "createdAt": "2024-01-15T10:30:00Z"
}
Custom Domain Setup
Host your status page on your own domain (Pro plan feature)
1

Add Custom Domain

Enter your custom domain (e.g., status.example.com) in the status page settings.

2

Configure DNS

Add a CNAME record pointing to your Wakestack status page:

status.example.com.  CNAME  wakestack.co.uk.
3

Verify & SSL

Once DNS propagates, we'll automatically provision an SSL certificate for your domain.

Troubleshooting

Need help? Check out our documentation or contact support.