Overview

Status Pages is part of Datadog’s Incident Response suite, alongside On-Call and Incident Management. It lets your team proactively communicate service availability, incidents, and planned maintenance 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
• Announce scheduled maintenance and planned downtime in advance
• Reduce inbound support volume with proactive email notifications

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 Status Pages.
2. Click Create Status Page and follow the onboarding flow:

   Field	Description
   Status Page Type	Choose who can access the page: - Public - Anyone with the link can view - Internal - 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. For more information on custom domains, see the Set a custom domain section. Example: shopist → shopist.statuspage.datadoghq.com - Must be globally unique - Lowercase, alphanumeric, and hyphenated - May affect links if changed later
   Subscriptions (optional)	Enable users to receive email notifications about status page updates. When subscriptions are enabled, users can sign up to get notified about new notices and updates. You can turn subscriptions on or off for each status page. Note: Email subscriptions are double opt-in, email must be confirmed.
   Company logo, Favicon, or Email Header Image (optional)	Upload a logo, favicon, or image to personalize the appearance of your status page and email notifications.

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 initial 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 notices 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

Component hierarchy

If multiple notices affect the same component, the notice with the greatest impact takes precedence: Major Outage > Partial Outage > Degraded Performance > Maintenance > Operational

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.
• Internal, access is limited to authenticated Datadog users in your organization.

Add a notice

Notices are messages published to a status page to communicate system status. Status Pages support two types of notices: degradations for unplanned service impact and maintenance windows for planned downtime.

Publish a degradation

Degradation notices communicate unplanned service impact, such as incidents or service disruptions. Use degradation notices to keep users informed as an issue is investigated, mitigated, and resolved.

From a status page, click Publish Notice and select Degradation, then provide:

After a degradation notice is reviewed and published, it:

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

You can publish updates over time and mark the notice as Resolved when the issue is fully mitigated.

Schedule a maintenance window

Maintenance windows allow you to proactively communicate planned downtime or service impact before it happens. Unlike degradations which are used for unplanned incidents, maintenance windows are scheduled in advance for infrastructure upgrades, system maintenance, database migrations, and other planned work. This allows you to keep customers informed and reduce support volume.

From the status page, click Schedule Maintenance, or click Publish Notice and select Scheduled Maintenance. Then, provide the following details:

After reviewing and scheduling, the maintenance window:

• Appears under Upcoming Maintenance on the status page
• Automatically updates component status to Maintenance when the window begins
• Returns components to Operational when the window ends (unless manually overridden)

You can post updates if plans change or reschedule the maintenance window as needed.

Email subscriptions

Email subscriptions on status pages are double opt-in. After entering an email to subscribe, users receive a confirmation email and must click the confirmation link to activate their subscription. During this process, users can choose to receive notifications for the entire status page or select specific components they want to monitor. Users can manage their preferences and update their subscriptions at any time through the subscription management link included in notification emails.

For internal status pages, the subscription process is the same, but users must log in to the same Datadog organization to confirm their subscription and receive notifications.

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.

Note:

• 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:

Keep stakeholders informed with Datadog Status PagesBLOG Learn more about Incident ManagementDOCUMENTATION Learn more about On-Call SchedulingDOCUMENTATION Integrate Datadog Status Pages with Incident ManagementDOCUMENTATION