Custom Fields on Services expand PagerDuty's capabilities by allowing you to define custom metadata for your services. This metadata supports more intelligent incident management, comprehensive reporting, and improved contextual navigation, all of which empower your organization to operate at a higher level of maturity.

📘

Availability and Limits

Custom Fields on Services is available with the following pricing plans:

• Business: Up to 15 custom fields
• Enterprise for Incident Management: Up to 30 custom fields

Disabled custom fields do not count towards this limit, however the sum of enabled plus disabled fields cannot exceed 35 for both pricing plans. Contact Sales to upgrade to a pricing plan with this feature.

📘

Required User Permissions

The Account Owner and Global Admins can create, edit, and delete Custom Fields on Services.

Users with permission to view and edit a service can also view and edit that service's custom field values.

Configure Custom Fields on Services

Create Custom Fields

Custom Fields on Services apply across all services on an account. When you create a new custom field, it will appear on all existing and future services in your PagerDuty account.

1. Navigate to Services Service Custom Fields.
2. Click New Field.
3. Enter the following information:

📘

Field Name and Field Type

The Field Name and Field Type values cannot be changed after initial creation.

4. Click Create Field. Repeat these steps for as many fields as needed.

Edit Custom Fields

1. Navigate to Services Service Custom Fields.
2. Click to the right of the field you would like to edit and select Edit.
3. Edit your preferred details and click Update Field.

Disable a Custom Field

When you disable a field, it is no longer editable on services. This will not erase values from existing services — they will still be visible on the service details page. Disable fields when you want to maintain existing data but no longer want to use the field.

1. Navigate to Services Service Custom Fields.
2. To the right of your desired field, select Disable.
3. In the confirmation modal, click Disable.

Delete a Custom Field

🛑

Deletion Warning

Deleting a custom field will permanently delete the field for all services and remove existing data. This action cannot be undone.

1. Navigate to Services Service Custom Fields.
2. To the right of your desired field, select Delete.
3. In the confirmation modal, click Delete.

Field Types

You can specify the field data type when you add a Custom Field. Data types help standardize and validate field data, preventing users from entering incorrect data types into a field. Custom Field types are:

• Text
• Single Select
• Multiple Select
• Tag
• URL
• Checkbox
• Datetime
• Decimal
• Integer

📘

Field Restrictions

You can only set a Custom Field's type once. To update a Custom Field's type, delete the old one and create a new one with the preferred type.

• String values have a maximum of 255 characters.
• Single Select and Multiple Select field types can have a maximum of 55 options.
• A custom field can have a maximum of 55 tags, and one tag can be up to 255 characters.
• URL values can have a maximum of 500 characters. Only absolute URLs are allowed, and must use one of the following schemes: http, https, tel.
• Datetime values must conform to either "full-date" or "date-time" as defined in RFC3339, section 5.6. Examples of supported values: 2025-03-14, 2024-04-28T11:53:12Z.

View Custom Fields

To view all Custom Fields on Services, navigate to Services Service Custom Fields.

To view Custom Fields on a specific service in the PagerDuty web app, navigate to Services Service Directory, select your preferred service, and select the Custom Fields tab.

You can also view and search by Service Custom Fields from the Service Directory page using the search bar. The search matches on field values only — not the field names — but both the field name and its value will be displayed in the results. This helps streamline the management and organization of your services, similar to the contextual search feature for other objects.

Edit Custom Field Values

You can fill out Custom Fields to assist you in service management and incident response.

1. In the PagerDuty web app, navigate to Services Service Directory and select your preferred service.
2. On the service's details page, select the Custom Fields tab and click Edit Fields.
3. Enter your desired value(s) in the applicable field(s).
4. Click Save.

FAQ

Can I create and manage Custom Fields on Services by using Terraform or the API?

Yes, you can create new Custom Fields as well as update, disable, or delete existing fields using the REST API or Terraform. You can also use these methods to update the Custom Field values on a service.

Refer to the Developer documentation for more information about using the REST API to manage Custom Fields.

Read the Terraform engineering blog and review the PagerDuty Provider Terraform documentation for more information about using Terraform.

Can I run reports on Custom Fields on Services data?

Yes, PagerDuty Analytics allows you to leverage the Services Custom Fields you have configured to gain deeper insights into how specific services are performing across your organization.

To get started, navigate to Analytics Insights Service Performance. Click to open the filter selection, then select Add to choose your desired filters, including Service Custom Fields, to tailor the report to your needs.

Can I sync PagerDuty Custom Fields with ServiceNow incident record fields?

Bi-directional syncing between PagerDuty Custom Fields on Services and ServiceNow incident record fields is currently in development and scheduled for later this year.

Can I view Service Custom Fields in the mobile app?

Service Custom Fields are currently not visible within the mobile app, however the ability to view Custom Fields on the service's details screen in the mobile app is planned for later this year.