Overview

Status Pages are part of Datadog’s Incident Response suite, alongside On-Call and Incident Management. They let your team proactively communicate real-time service availability, incidents, and maintenance updates with customers or internal stakeholders through a shareable web page.

Use Status Pages to:

• Share the availability of critical systems and features
• Communicate service disruptions clearly during incidents
• Reduce inbound support volume with proactive updates

Configure permissions

There are three RBAC permissions that are relevant to Status Pages. Users with the Datadog Admin Role have all the necessary permissions.

To create, update, or publish Status Pages, you must have status_pages_settings_read, status_pages_settings_write, and status_pages_incident_write RBAC permissions. For more information, see Access Control.

Create a status page

1. In Datadog, navigate to Service Management > Status Pages.
2. Click Create Status Page and follow the onboarding flow:

   Field	Description
   Visibility	Choose who can access the page: - Public - Anyone with the link can view - Private - Only authenticated users within your Datadog organization can view
   Page name	Displayed as the page header (if no logo is uploaded). Example: Acme Cloud Platform
   Domain Prefix	Used as your status page subdomain prefix. Example: shopist → shopist.status.datadoghq.com - Must be globally unique - Lowercase, alphanumeric, and hyphenated - May affect links if changed later
   Company logo or Favicon (optional)	Upload a logo or favicon to personalize the appearance of your status page

3. (Optional) Add components to show the status of individual services.
4. Click Save Settings.
   A status page is not Live after you save your settings. To make the page available, publish your status page.

Add components

Components are the building blocks of your status page. Each one represents a service or feature your users care about. Some examples of components include:

• API Gateway
• Web Dashboard
• Database Cluster
• US Region Services

You can add components to your status page either on intial setup or through the status page settings:

1. From your status page, click Settings and select the Components tab.
2. Create individual components or a group of related components. You can associate incidents with these components to reflect impact on your status page.
3. Select a visualization type:
   1. Bars and Uptime Percentage
   2. Bars Only
   3. Component Name Only

Publish your status page

After you save your status page settings, click Launch Status Page to make the page available at its URL.

If you selected:

• Public, the page is immediately accessible to all visitors.
• Private, access is limited to authenticated Datadog users in your organization.

Add an incident

When an issue arises, you can communicate it clearly through your status page.

1. From a status page, click Publish Incident to open a “Publish Status Page Incident” modal and provide:

   Field	Description
   Title	Short, clear description of the incident Example: Increased error rates on US region
   Status	Current state of the incident: - Investigating - Identified - Monitoring - Resolved
   Message (optional)	Additional details for your users Examples: known cause, expected resolution time
   Affected Components	One or more components impacted by the incident
   Impact	Level of impact per component: - Operational - Degraded Performance - Partial Outage - Major Outage

2. Click Publish Incident.

After an incident is published, the incident:

• Appears on the Status Pages List under Active Incidents.
• Updates the uptime bars for impacted components.
• Is visible in the incident history timeline.

You can post updates over time to keep users informed, and then mark the incident as Resolved.

Set a custom domain

To match your branding, you have the option to map your status page to a custom domain like status.acme.com.

1. From your status page, click Settings.
2. Select Custom Domain.
3. Follow the instructions to enter your domain and add DNS records.
4. Datadog automatically detects the DNS configuration and provisions an SSL certificate.

Notes:

• DNS propagation may take several minutes.
• You can revert to the default Datadog domain at any time.
• Ensure DNS changes are made by someone with access to your domain registrar.

Further reading

Additional helpful documentation, links, and articles:

Learn more about Incident ManagementDOCUMENTATION Learn more about On-Call SchedulingDOCUMENTATION