Incident Display Position
Control where active incidents are displayed on your public status page.
Overview
By default, active incidents appear at the top of your status page for maximum visibility. However, you can customize this position based on your preference and use case.
Available Positions
1Top (Default)
Incidents appear at the very top of the status page, above everything else.
Best for: Critical incident visibility, immediate user awareness
2Below Status
Incidents appear after the overall status but before the component list.
Best for: Balanced visibility, showing overall status first
3Below Components
Incidents appear after the component list, at the bottom of the main content.
Best for: Component-focused pages, detailed service status
How to Configure
- Log in to your admin panel
- Navigate to Admin → Features
- Find the Incident Display Position setting
- Select your preferred position from the dropdown:
top- At the top of the pagebelow_status- Below the overall statusbelow_components- Below the component list
- Click Save Changes
Changes take effect immediately after saving. No rebuild or restart required.
API Configuration
You can also configure the incident position via the Features API:
PUT /api/features
Content-Type: application/json
Authorization: Bearer <your-api-key>
{
"incidentPosition": "below_status"
}
// Response
{
"success": true,
"data": {
"incidentPosition": "below_status",
// ... other settings
}
}Valid Values
| Value | Position |
|---|---|
"top" | Top of page (default) |
"below_status" | Below overall status |
"below_components" | Below component list |
Component Status Behavior
Regardless of where incidents are displayed, they still affect component status:
- Linked components automatically show "Partial Outage" status
- Parent groups of affected components also reflect the incident status
- Overall status is calculated based on the worst component status
The incident display position only changes where the incident card appears. Component status indicators always update regardless of incident position.
Recommendations
| Use Case | Recommended Position | Reason |
|---|---|---|
| Public SaaS status page | Top | Users want to immediately know about issues |
| Internal IT dashboard | Below Status | Balance between overview and detail |
| Multi-service platform | Below Components | Focus on which services are affected |