The Required Fields on Resolve feature allows you to tailor the incident resolution experience to your team’s unique needs. By configuring which fields appear, adding custom options, and setting required fields, you can ensure that every incident captures the most relevant and structured information. This streamlines the resolution process and guarantees consistent data collection for effective post-incident analysis and reporting.

The Required Fields on Resolve feature includes:

• Your customized fields, in the order specified, on the Incident Resolution Form
• Clearly-marked required fields (Enterprise for Incident Management plan only)
• Optional fields for additional context
• The standard resolution notes field

🚧

Required User Permissions

Global Admins and Account Owners can configure Incident Resolution Forms.

📘

Supported Interfaces

Required fields on resolution are supported in the Web App, Slack, and Mobile App only. They are not supported when resolving incidents via SMS or Voice notifications. In those cases, the required field prompts do not appear, and incidents resolve without the required details being captured.

Configure an Incident Resolution Form

📘

Prerequisites

You must first configure Incident Types with Custom Fields prior to configuring an Incident Resolution Form.

1. Navigate to Incidents Incident Types.
2. Select the Forms tab.
3. Click Add Field to add field(s) to the resolve form.
4. Select the field(s) you want to add. You might see:
   • Fields specific to your incident type (e.g., Root Cause, Customer Impact)
   • Inherited fields from base types (e.g., Environment URL)
   • System fields (e.g., Priority)
5. (Optional,Enterprise for Incident Management Plans Only) Check the Required checkbox to make the field(s) required to resolve the incident.
6. Click Add Fields to confirm your selection.

Edit Field Order

You can edit the order in which fields appear on your Incident Resolution form.

1. Navigate to Incidents Incident Types.
2. Select the Forms tab.
3. Click the overflow menu to the right of the field you want to move.
4. Select Move Up or Move Down to arrange fields in your preferred order.**
   Tip: Position the most important fields at the top of the form.

Test Incident Resolution Form User Experience

To preview the form:

1. Navigate to an open incident.
2. Click Resolve to preview how the form appears to end users.
3. Verify that required fields are properly marked and that the field order meets your needs.

📘

Notes

• Field visibility and requirements are configured in the PagerDuty web app. Keep those definitions up to date to ensure consistent behavior on mobile.
• The mobile experience mirrors the web experience's configuration.
• Any field marked with a red asterisk is required before an incident can be resolved.