Overview

Incident variables are template variables that dynamically inject incident data into notifications, postmortems, and Jira issues. Use them to automatically populate templates with relevant incident context, reducing manual effort during and after an incident.

Variables are available in three template types:

  • Notifications: Used in manual and automated incident notifications sent to email, Slack, or other channels.
  • Postmortem templates: Used to auto-populate Datadog Notebooks or Confluence pages when generating a postmortem.
  • Jira templates: Used to map incident fields to Jira issue fields when a Jira issue is created from an incident.

Note: In Jira templates, variables are displayed without their prefix. For example, {{incident.title}} appears as {{ title }} in the Jira template editor. The variables behave the same way.

Incident variables

The following variables are available in notification messages, postmortem templates, and Jira templates.

VariableDescription
{{incident.<property_field_name>}}Any custom property field configured for your organization. Replace <property_field_name> with the field name.
{{incident.id}}The incident’s public ID.
{{incident.title}}The incident title.
{{incident.severity}}The incident severity (for example, SEV-1, SEV-2).
{{incident.status}}The incident status level.
{{incident.created}}Timestamp when the incident was created.
{{incident.detected}}Timestamp when the incident was detected.
{{incident.resolved}}Timestamp when the incident was resolved.
{{incident.customer_impacted}}True or False, depending on whether an impact has been added to the incident.
{{incident.customer_impact}}A description of the impacts and their duration.
{{incident.scope_of_impact}}A list of the impact descriptions.
{{incident.customer_impact_start}}The start time of the impact. If multiple impacts were added, this is the earliest start time.
{{incident.customer_impact_end}}The end time of the impact. If multiple impacts were added, this is the latest end time.
{{incident.customer_impact_duration}}The total duration of the impacts, from customer_impact_start to customer_impact_end.
{{incident.commander}}The incident commander’s name. If the user has no name, this is their email. If they have no email, this is their handle.
{{incident.commander_name}}The incident commander’s name.
{{incident.commander_handle}}The incident commander’s handle.
{{incident.commander_email}}The incident commander’s email address.
{{incident.created_by_name}}The name of the user who created the incident.
{{incident.created_by_handle}}The handle of the user who created the incident.
{{incident.created_by_email}}The email address of the user who created the incident.
{{incident.responders_summary}}A summary of the incident’s responders, truncated if there are many responders.
{{incident.responders_full_list}}The full, non-truncated list of the incident’s responders.
{{incident.slack_channel_name}}The name of the incident’s Slack channel.
{{incident.slack_channel_url}}The URL of the incident’s Slack channel.
{{incident.slack_channel_link}}A Markdown link to the incident’s Slack channel.
{{incident.ms_teams_channel_name}}The name of the incident’s Microsoft Teams channel.
{{incident.ms_teams_channel_url}}The URL of the incident’s Microsoft Teams channel.
{{incident.ms_teams_channel_link}}A Markdown link to the incident’s Microsoft Teams channel.
{{incident.zoom_id}}The Zoom meeting ID.
{{incident.zoom_join_url}}The Zoom join URL.
{{incident.zoom_password}}The Zoom meeting password, if one exists.
{{incident.zoom_link}}A Markdown link to the Zoom meeting. The display text is Zoom Meeting {id}.

Variables available only in postmortem templates

The following variables work only in postmortem templates. They are not available in notification or Jira templates.

VariableDescription
{{incident.card}}Inserts a self-updating incident card into the postmortem. Only available for postmortems created in Datadog Notebooks. This variable does not work for postmortems created in third-party locations such as Confluence or Google Drive.
{{incident.timeline}}Copies all timeline events from the incident into the postmortem when used in a postmortem template.

AI variables

AI variables are not supported in .

AI variables are available in notification and postmortem templates. Your organization must have AI enabled.

Notification templates

VariableDescription
{{incident.ai_issue}}An AI-generated description of the issue that occurred.
{{incident.ai_impact}}An AI-generated description of the impact.
{{incident.ai_remediation}}An AI-generated description of the remediation steps taken.
{{incident.ai_contributing_factors}}An AI-generated summary of the contributing factors.

Postmortem templates

VariableDescription
{{incident.ai_summary}}An AI-generated summary of the incident.
{{incident.ai_system_overview}}An AI-generated description of the involved services.
{{incident.ai_key_timeline}}An AI-generated key timeline of events.
{{incident.ai_customer_impact}}An AI-generated description of the customer impact.
{{incident.ai_lessons_learned}}An AI-generated summary of lessons learned.
{{incident.ai_action_items}}An AI-generated list of action items.

Further reading