---
title: Transition Forms
description: Prompt incident responders to fill out specific fields on status changes.
breadcrumbs: >-
  Docs > Incident Response > Incident Management > Setup and Configuration >
  Transition Forms
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Transition Forms

## Overview{% #overview %}

Any time an incident progresses through status changes, you can guide responders to fill out fields on the incident with transition forms. These forms help ensure that information about the incident is collected at the right time in the incident response process. For example, you can create a form that requires responders to select a team and postmortem owner before an incident is resolved. This form would be shown to responders as they resolve the incident in Datadog, Slack, or Microsoft Teams.

{% image
   source="https://docs.dd-static.net/images/incident_response/incident_management/setup_and_configuration/status_transition_form.0fa5eb31972e371357e8ea9f477defb3.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/incident_response/incident_management/setup_and_configuration/status_transition_form.0fa5eb31972e371357e8ea9f477defb3.png?auto=format&fit=max&w=850&dpr=2 2x"
   alt="Status Change form prompting the user to fill out the required Teams and Postmortem Owner fields when moving an incident to Resolved" /%}

{% alert level="info" %}
Required fields on transition forms apply only to status changes made by a human. Automated status changes, such as those triggered through the API or [incident automations](https://docs.datadoghq.com/incident_response/incident_management/setup_and_configuration/automations.md), are not blocked.
{% /alert %}

## Prerequisites{% #prerequisites %}

To set up transition forms, you must have the `Incident Settings Write` permission. For more information, see [Datadog Role Permissions](https://docs.datadoghq.com/account_management/rbac/permissions.md#case-and-incident-management).

## Configure a transition form{% #configure-a-transition-form %}

1. In Datadog, navigate to **Incidents** > [**Settings**](https://app.datadoghq.com/incidents/settings).
1. Under **Incident Types**, expand an incident type to edit.
1. Click the **Transition Forms** tab.
1. Select the status you want to configure.
1. Choose which fields appear on the form. You can add [property fields](https://docs.datadoghq.com/incident_response/incident_management/setup_and_configuration/property_fields.md) and [responder types](https://docs.datadoghq.com/incident_response/incident_management/setup_and_configuration/responder_types.md). Any field can be marked as required or optional.
1. Click **Save**.