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

Please note, disabled custom fields do not count towards this limit, however the sum of enabled plus disabled fields cannot exceed 35 for both pricing plans. Please 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:

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 the menu to the right of the field you would like to edit and select Edit.
3. Edit your preferred details and then click Update Field.

Disable a Custom Field

When you disable a field, it is no longer editable on services. However, this will not erase values from existing services (i.e., they will still be visible on the service details page). You should 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. If you wish to update a Custom Field's type, please 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 tab Custom Fields.

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 our 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 tab Custom Fields 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?

Can I run reports on Custom Fields on Services data?

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

Can I view Service Custom Fields in the mobile app?