diff --git a/content/en/incident_response/status_pages/_index.md b/content/en/incident_response/status_pages/_index.md index c6123f1b434..90636174f5a 100644 --- a/content/en/incident_response/status_pages/_index.md +++ b/content/en/incident_response/status_pages/_index.md @@ -237,6 +237,46 @@ From a status page, select the dropdown next to **Publish Notice**, select **Pub {{< img src="incident_response/status_pages/publish_status_page_backfill_maintenance.png" alt="Example publish backfilled notice modal for maintenance windows" style="width:60%;" >}} +## Use notice templates + +Templates let you save pre-configured language for degradation notices and maintenance windows that you publish repeatedly, such as a recurring maintenance activity or a known type of service disruption. When you publish a notice, select a template to pre-fill the notice title, per-status messages, and affected components instead of typing them each time. + +### Create a template + +1. From your status page, click **Settings** and select the **Templates** tab. +1. In the **Degradation Templates** or **Maintenance Templates** section, click **Add Template**. +1. Provide the following details: + + | Field | Description | + | ---- | ---- | + | **Template name** | Internal name used to identify the template when selecting it. Not shown on the published status page. | + | **Notice Title** | Default title pre-filled when the template is used. | + | **Messages** | A message for each notice status. Degradation templates support **Investigating**, **Identified**, **Monitoring**, and **Resolved**. Maintenance templates support **Scheduled**, **In Progress**, and **Completed**. | + | **Components** | Components to pre-select when the template is used. For degradation templates, you can also set an initial status for each component. | + +1. Click **Save**. + +{{< img src="incident_response/status_pages/create_degradation_template.png" alt="Create a degradation template with a title, per-status messages using template variables, and impacted components" style="width:100%;" >}} + +### Insert template variables + +Insert a variable into a template message to have Datadog resolve it when the template is applied to a notice, either automatically or by prompting the publisher for a value. The **Message Variables** panel next to the message fields lists the available variables: + +| Variable | Description | +| ---- | ---- | +| `{{date}}` | Prompts the publisher to select a date and time when the template is applied. | +| `{{components_impacted}}` | Automatically fills in the list of components selected on the notice. | + +To insert a variable, type `{{` in a message field and select a variable from the list, or click a variable in the **Message Variables** panel to insert it at the cursor. + +### Apply a template to a notice + +From the **Publish Notice** modal, select a template from the **Template** dropdown to pre-fill the notice with its title, messages, and components. + +Applying a template pre-fills the notice's fields, which remain editable and can be overridden if necessary, with a **Reset Values** option to revert to the original template content. + +{{< img src="incident_response/status_pages/apply_template_to_notice.png" alt="Publish Notice modal with a template applied, pre-filling the notice title, message, and impacted components" style="width:60%;" >}} + ## 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. A preferred timezone can be configured for timestamp formatting within notifications. Users can manage their preferences and update their subscriptions at any time through the subscription management link included in notification emails. diff --git a/static/images/incident_response/status_pages/apply_template_to_notice.png b/static/images/incident_response/status_pages/apply_template_to_notice.png new file mode 100644 index 00000000000..a0ca673891c Binary files /dev/null and b/static/images/incident_response/status_pages/apply_template_to_notice.png differ diff --git a/static/images/incident_response/status_pages/create_degradation_template.png b/static/images/incident_response/status_pages/create_degradation_template.png new file mode 100644 index 00000000000..c5c448c57ac Binary files /dev/null and b/static/images/incident_response/status_pages/create_degradation_template.png differ