Menu
Documentationbreadcrumb arrow Grafana Cloudbreadcrumb arrow Alerts and IRMbreadcrumb arrow IRMbreadcrumb arrow Configurebreadcrumb arrow Incident settingsbreadcrumb arrow Custom incident fields
Grafana Cloud

Configure custom incident fields

Grafana IRM allows you to add custom incident fields to capture organization-specific metadata relevant to your incident management process.

This feature provides the flexibility to customize incidents according to your unique workflows and requirements, ensuring that important details are properly recorded.

Supported data types

You can define custom fields with various input types to capture important incident details and perform incident analysis.

When creating custom fields, you can choose from the following input types:

  • Text: A simple text input for freeform data
  • Number: A numerical input for quantitative data
  • Single-select: A dropdown menu that allows selection of one predefined option
  • Multi-select: A dropdown menu that allows selection of multiple predefined options

Add a custom field

To create a custom field:

  1. In the Grafana Cloud main menu, click IRM > Settings.
  2. Select the Incidents tab.
  3. Locate the Custom fields section.
  4. Click + Add field.
  5. Configure the following settings:
    • Name: Enter a descriptive name for the custom field (for example, Region, or Service Impacted).
    • Description: (Optional) Add a description that explains the purpose of this field to your team.
    • Type: Select the field input type (Text, Number, Single-select, or Multi-select).
    • Mandatory: Toggle this option if the field must be completed before resolving an incident.
  6. Click Save.

Edit a custom field

To modify an existing custom field:

  1. In the Grafana Cloud main menu, click IRM > Settings.
  2. Select the Incidents tab.
  3. Scroll to the Custom fields section.
  4. Click the pencil icon next to the field you want to modify.
  5. Update any of the following:
    • Name
    • Description
    • Type
    • Mandatory status
  6. Click Save.

Delete a custom field

Warning

Deleting a custom field permanently removes it and cannot be undone. Consider editing the field instead if you might need it later.

To delete a custom field:

  1. In the Grafana Cloud main menu, click IRM > Settings.
  2. Select the Incidents tab.
  3. Locate the Custom fields section.
  4. Click the trash icon next to the field you want to remove.
  5. Click Confirm remove.

Use custom fields during an incident

You can add or update custom field values for both active and resolved incidents:

  1. Navigate to the incident page.
  2. Locate the Custom Fields section in the right sidebar.
  3. Click the section to expand it.
  4. Enter values based on the field type:
    • Text fields: Type your text directly
    • Number fields: Enter a numerical value
    • Single-select fields: Choose one option from the dropdown menu
    • Multi-select fields: Select one or more options from the dropdown menu

Note

When resolving an incident, you must complete all mandatory custom fields before the incident can be resolved.

Best practices

Consider these recommendations when configuring custom fields:

  1. Use clear, descriptive field names that align with your organization’s terminology
  2. Add helpful descriptions to guide users on how to use each field
  3. Use single-select or multi-select fields when possible to maintain consistent data
  4. Limit the number of custom fields to prevent information overload during incident response
  5. Make fields mandatory only when the information is essential for incident analysis