Status Page Incident Integration (#31944)

* Add documentation for Status Pages integration within Incident App

* Cross link docs and add to left nav menu

* Add images

* Fix force push issue and update overview

* Fix typos

* Address review and more fixes

* Remove Update Status Page part

* Fix link

* Small typo fix

---------

Co-authored-by: Esther Kim <[email protected]>

Author: jbenais

config/_default/menus/main.en.yaml

@@ -2458,18 +2458,23 @@ menu:
     - name: Jira
       url: service_management/incident_management/integrations/jira
       parent: incidents_integrations
-      identifier: incidents_jira
+      identifier: incidents_integrations_jira
       weight: 901
     - name: Slack
       url: service_management/incident_management/integrations/slack
       parent: incidents_integrations
-      identifier: incidents_slack
+      identifier: incidents_integrations_slack
       weight: 902
+    - name: Status Pages
+      url: service_management/incident_management/integrations/status_pages
+      parent: incidents_integrations
+      identifier: incidents_integrations_status_pages
+      weight: 903
     - name: Statuspage
       url: service_management/incident_management/integrations/statuspage
       parent: incidents_integrations
-      identifier: incidents_statuspage
-      weight: 903
+      identifier: incidents_integrations_statuspage
+      weight: 904
     - name: On-Call
       url: service_management/on-call/
       pre: on-call

content/en/service_management/incident_management/integrations/_index.md

@@ -11,7 +11,7 @@ further_reading:
 
 Datadog Incident Management integrates with third-party platforms to support collaboration and response. Integrations connect your incident workflows with ticketing systems, communication channels, and status pages so your teams can coordinate, escalate, and resolve incidents in their existing tools.
 
-Use integrations in Datadog Incident Management to:**
+Use integrations in Datadog Incident Management to:
 
 - **Automate workflows:** Trigger actions in external systems (such as creating Jira tickets or updating Statuspage) directly from Datadog incidents.
 - **Centralize communication:** Sync incident updates and notifications with chat tools, ticketing platforms, and on-call systems to keep stakeholders informed.
@@ -26,11 +26,12 @@ Configure and manage incident-related integrations from the **Incident Settings*
 {{< whatsnext desc="Set up and use the following integrations within the context of Datadog Incident Management:">}}
     {{< nextlink href="/service_management/incident_management/integrations/jira" >}}Jira{{< /nextlink >}}
     {{< nextlink href="/service_management/incident_management/integrations/slack" >}}Slack{{< /nextlink >}}
-    {{< nextlink href="/service_management/incident_management/integrations/statuspage" >}}Statuspage{{< /nextlink >}}
+    {{< nextlink href="/service_management/incident_management/integrations/status_pages" >}}Status Pages{{< /nextlink >}}
+    {{< nextlink href="/service_management/incident_management/integrations/statuspage" >}}Atlassian Statuspage{{< /nextlink >}}
 {{< /whatsnext >}}
 
 ## Further reading
 
 {{< partial name="whats-next/whats-next.html" >}}
 
-[1]: /service_management/incident_management/incident_settings/integrations
+[1]: /service_management/incident_management/incident_settings/integrations

content/en/service_management/incident_management/integrations/status_pages.md

@@ -1,19 +1,56 @@
 ---
-title: Datadog Status Pages
+title: Integrate Datadog Status Pages with Datadog Incident Management
+description: Learn how to integrate Datadog Status Pages with Incident Management to communicate real-time service status during incidents.
 further_reading:
-- link: "service_management/status_pages/"
+- link: "/service_management/status_pages/"
   tag: "Documentation"
-  text: "Learn more about Status Pages"
+  text: "Learn more about Datadog Status Pages"
 ---
 
 ## Overview
 
+Status Pages is a way to keep internal and external stakeholders informed during service disruptions by publishing real-time updates about system health.
 
+This integration enables responders to publish and update status page notices directly from Incident Management.
+- Eliminate context switching by managing public communications without leaving your incident workflow
+- Publish notices quickly and consistently during high-severity incidents
+- Keep incident timelines and public-facing updates in sync to reduce confusion and messaging mistakes
 
+## Prerequisites
 
+At least one status page is required to enable the Status Pages integration for Incident Management.
 
+You must have a role with the Incident Settings Write permission to enable the Status Pages integration for Incident Management.
 
+## Setup
 
-## Further reading
+1. In the [Integration Settings page][1], find the Status Pages integration.
+1. Toggle **Enable Status Pages notice creation**.
 
-{{< partial name="whats-next/whats-next.html" >}}
+## Publish a Status Pages notice
+
+You must have a role with Incidents Write and Status Pages Notice Write permissions to add a Status Pages notice from an incident.
+
+{{< img src="/service_management/incidents/Integrations/status_pages/status_pages_config_modal.png" alt="Configuration modal for integrating a Datadog incident with a status page notice" style="width:70%;" >}}
+
+1. In the [Incidents List page][2], open an existing incident.
+1. At the top of the incident page, click **Update Status Page**.
+1. Enter all the required fields, including _Select a Status Page_, _Notice title_, and _Notice status_. You can also specify which status page components are affected.
+
+## Update a Status Pages notice
+
+After a notice is added to an incident, you can continue updating the status page until the incident is resolved.
+
+{{< img src="/service_management/incidents/Integrations/status_pages/incident_status_pages.png" alt="Screenshot showing the integration of a Datadog incident with a Status Page notice, including fields for selecting a status page, notice title, and status" style="width:100%;" >}}
+
+1. In the [Incidents List page][2], open the incident you want to update.
+1. At the top of the incident page, find the status page you added, and hover over the button to open the integration modal. You can update the current status page notice or unlink the notice.
+1. Click **Update** to update the status page notice.
+
+## Further Reading
+
+{{< partial name="whats-next/whats-next.html" >}}
+
+[1]: https://app.datadoghq.com/incidents/settings?section=integrations
+[2]: https://app.datadoghq.com/incidents
+[3]: /account_management/rbac/permissions

content/en/service_management/incident_management/integrations/statuspage.md

@@ -1,18 +1,18 @@
 ---
-title: Integrate Statuspage with Datadog Incident Management
+title: Integrate Atlassian Statuspage with Datadog Incident Management
 aliases:
 - /service_management/incident_management/guides/statuspage
 further_reading:
 - link: "integrations/statuspage/"
   tag: "Documentation"
-  text: "Install the Statuspage Integration"
+  text: "Install the Atlassian Statuspage Integration"
 - link: "https://app.datadoghq.com/integrations/statuspage"
   tag: "App"
   text: "In-app Statuspage integration tile"
 - link: "monitors/guide/integrate-monitors-with-statuspage/"
   tag: "Guide"
   text: "Integrating Monitors With Statuspage"
-- link: "synthetics/guide/synthetic-test-monitors/#integrate-your-synthetic-test-monitor-with-statuspage"
+- link: "synthetics/guide/synthetic-test-monitors/#integrate-your-synthetic-test-monitor-with-atlassian-statuspage"
   tag: "Guide"
   text: "Integrate your Synthetic test monitor with Statuspage"
 ---
@@ -28,10 +28,12 @@ Atlassian's Statuspage conveys real-time status of an organization's services on
 
 Install the integration through the [Statuspage Integration tile][1]. For more information, see the [Statuspage integration][2] documentation.
 
+You must have a role with the Incident Settings Write permission to enable the Atlassian Statuspage integration for Incident Management.
+
 ## Setup
 
-1. In the [Integration Settings page][3], find the Statuspage integration.
-1. Toggle **Enable Statuspage incident creation**.
+1. In the [Integration Settings page][3], find the Atlassian Statuspage integration.
+1. Toggle **Enable Atlassian Statuspage incident creation**.
 
 ## Add a Statuspage incident
 
@@ -60,5 +62,5 @@ After a Statuspage is added to an incident, you can continue updating the Status
 
 [1]: https://app.datadoghq.com/integrations/statuspage
 [2]: /integrations/statuspage/
-[3]: https://app.datadoghq.com/incidents/settings#Integrations
+[3]: https://app.datadoghq.com/incidents/settings?section=integrations
 [4]: https://app.datadoghq.com/incidents

content/en/service_management/status_pages/_index.md

@@ -7,6 +7,9 @@ further_reading:
 - link: "service_management/on-call/"
   tag: "Documentation"
   text: "Learn more about On-Call Scheduling"
+- link: "service_management/incident_management/integrations/status_pages"
+  tag: "Documentation"
+  text: "Integrate Datadog Status Pages with Incident Management"
 ---
 
 ## Overview