How do status page components work?
Attach monitors to your status page as components to show real-time service health.
Components are the individual service entries that appear on your status page. Each component is backed by one of your monitors - when the monitor changes state, the component updates automatically.
How Monitor States Map to Component Status
Each component inherits its status directly from its attached monitor:
| Monitor state | Component displays |
|---|---|
| Up | Operational (green) |
| Degraded | Degraded Performance (yellow) |
| Down | Outage (red) |
| Paused | Maintenance (grey) |
There is no manual override - the status always reflects what your monitors actually detect. This is intentional: it prevents the credibility gap that comes from manually managed status pages that lag behind reality.
Adding Components to a Status Page
When creating or editing a status page, click Add Component in the Components section:
- Select a monitor from your account’s monitor list.
- Enter a display name - this is what visitors see, so use plain language: “Website”, “API”, “Checkout”, “Admin Panel”, “Background Jobs”.
- Optionally assign the component to a group (see below).
- Click Add.
Each monitor can only be attached to one status page at a time. If you need the same service visible on multiple pages, create separate monitors for each.
Ordering Components
The order components appear on the page matters - most critical services should appear first. Drag components up or down in the component list to reorder them. The order is saved immediately.
A recommended ordering strategy:
- Customer-facing services first (website, app, checkout)
- API and developer services next
- Internal or supporting services last (background jobs, admin, analytics)
Component Groups
Groups let you organize components into labeled sections. This is useful when you have many components or want to separate frontend services from backend infrastructure.
To create a group:
- In the layout editor, add a Component Groups block to your page layout.
- When adding or editing a component, select a group name from the dropdown or type a new group name to create it.
- Components in the same group appear together under that group’s label.
Groups display a collapsed summary status - if any component in the group is degraded or down, the group header shows a warning indicator even when the group is collapsed.
Removing a Component
To remove a component from a status page, click the component in the editor and choose Remove. This does not delete the underlying monitor - it only removes it from the page. The monitor continues checking and alerting normally.
What Visitors See
For each component, visitors see:
- Display name - the label you set
- Status badge - Operational, Degraded, or Outage
- Uptime history bar - a 30, 60, or 90-day visual availability record (configurable)
- Response time - current average response time across regions (in Detailed display mode)
Hovering a segment of the uptime history bar shows the date and uptime percentage for that period.
Related Documentation
- Monitor Overview - Monitor types you can attach as components
- Status Page Overview - How components fit into your status page
- Create a Status Page - Add components during page creation
- Service Dependencies - Show third-party service status alongside your components