Status Pages
Status pages provide a real-time view of your service health. They display monitor status, uptime history, and incident timelines — either publicly or behind authentication.
How Status Pages Work
Section titled “How Status Pages Work”Warden automatically creates a status page for every group you create. This means you never have to manually set up status pages — they’re ready to configure as soon as you organize your monitors into groups.
In addition to per-group pages, there’s a global All status page that shows monitors from every group in a single view.
Example
Section titled “Example”If you create three groups — “Production”, “Staging”, and “Acme Corp” — Warden automatically generates:
| Status Page | URL | Shows |
|---|---|---|
| Production | /status/production | Only monitors in the Production group |
| Staging | /status/staging | Only monitors in the Staging group |
| Acme Corp | /status/acme-corp | Only monitors in the Acme Corp group |
| All | /status/all | Monitors from all groups |
This design eliminates double work — you organize monitors into groups, and status pages follow automatically.
Enabled vs Disabled
Section titled “Enabled vs Disabled”Auto-created status pages start as disabled. They exist in Settings but return a 404 until you enable them. This lets you set up your groups and monitors at your own pace, then turn on status pages when you’re ready to share them.
Public vs Private
Section titled “Public vs Private”Each status page can be configured as public or private:
| Mode | Access | Use Case |
|---|---|---|
| Public | Anyone with the URL — no login needed | Customer-facing status pages, transparency dashboards |
| Private | Requires authentication (session or API key) | Internal teams, pre-launch environments |
Sharing Private Pages with External Users
Section titled “Sharing Private Pages with External Users”For situations where you need to share a private status page with someone who shouldn’t have dashboard access — like a client in a multi-tenant setup — use the Status Viewer role:
- Create a user with the Status Viewer role in Settings → Users
- Assign the specific status pages they should see
- Share the credentials
Status Viewers see only their assigned pages after logging in. They have no access to the dashboard, monitors, or any other part of Warden.
This is configurable per user — you can assign one or many status pages to each Status Viewer. See User Management for details.
Configuring a Status Page
Section titled “Configuring a Status Page”- Navigate to Settings → Status Pages
- Find the page you want to configure (one exists per group, plus the All page)
- Toggle Enabled to make it accessible
- Choose Public or Private
- Customize branding and display options
- Save
Core Settings
Section titled “Core Settings”| Setting | Description |
|---|---|
| Slug | URL-friendly identifier (auto-generated from group name) |
| Title | Display name shown on the page |
| Group | The group this page is linked to (set automatically) |
| Public | Whether the page is accessible without authentication |
| Enabled | Whether the page is accessible at all |
| Description | Optional tagline shown below the title |
Branding
Section titled “Branding”| Setting | Default | Description |
|---|---|---|
| Logo URL | — | URL to your logo image (HTTP/HTTPS or data URI) |
| Favicon URL | — | Browser tab icon (HTTP/HTTPS or data URI) |
| Accent Color | — | Primary color in hex format (e.g., #06b6d4) |
| Theme | System | Force light, dark, or follow system preference |
Header Layout
Section titled “Header Layout”| Setting | Options | Default |
|---|---|---|
| Content | Logo & title, Logo only, Title only | Logo & title |
| Alignment | Left, Center, Right | Center |
| Arrangement | Stacked (logo above title), Inline (side by side) | Stacked |
Display Options
Section titled “Display Options”| Setting | Default | Description |
|---|---|---|
| Show Uptime Bars | Yes | Display per-day uptime history bars for each monitor |
| Show Uptime Percentage | Yes | Display overall uptime percentage |
| Show Incident History | Yes | Display past incidents section |
| Uptime Days Range | 90 | Days of history to show (7, 30, 60, 90, 180, or 365) |
What Appears on a Status Page
Section titled “What Appears on a Status Page”System Status Banner
Section titled “System Status Banner”A banner at the top shows the overall system health:
| Banner | Condition |
|---|---|
| All Systems Operational | All monitors are up |
| Partially Degraded Service | One or more monitors are degraded |
| System Outage | One or more monitors are down |
| System Under Maintenance | An active maintenance window exists |
Monitor List
Section titled “Monitor List”Each monitor shows:
- Current status (Operational, Degraded, Down, Paused, Maintenance)
- Uptime history bars (color-coded by daily uptime percentage)
- Overall uptime percentage
Uptime bar colors:
| Color | Uptime |
|---|---|
| Green | 100% |
| Light green | 99–99.99% |
| Yellow | 95–98.99% |
| Orange | 90–94.99% |
| Red | Below 90% |
| Gray | No data |
Active Incidents
Section titled “Active Incidents”Current incidents are displayed prominently with:
- Severity badge (critical or warning)
- Title and description
- Duration
- Affected groups
- Timeline of updates
Group-specific status pages only show incidents that affect their group.
Active Maintenance
Section titled “Active Maintenance”Active maintenance windows are shown separately from incidents.
Past Incidents
Section titled “Past Incidents”If enabled, a reverse-chronological list of resolved public incidents appears at the bottom.
RSS Feeds
Section titled “RSS Feeds”Each status page has an RSS feed available at:
https://your-warden-instance.com/api/s/your-slug/rssThe feed includes:
- Public incidents from the last 30 days
- Incident title with severity prefix (e.g., “[CRITICAL] Database Outage”)
- Description with duration and affected groups
- Maintenance events prefixed with “[MAINTENANCE]”
The RSS feed follows the same access rules as the status page — public pages have public feeds, private pages require authentication.