From 1a836fd2476998fe11ef93a8ebb62ec297996ba8 Mon Sep 17 00:00:00 2001 From: Tracey Li Date: Thu, 6 Nov 2025 11:18:38 -0500 Subject: [PATCH] Add a Field names section to the incident property fields page Incident property fields have a name and a display name so we want a few sentences to describe their differences. --- .../incident_settings/property_fields.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/content/en/service_management/incident_management/incident_settings/property_fields.md b/content/en/service_management/incident_management/incident_settings/property_fields.md index 75b60ac71be..ffa48f24b30 100644 --- a/content/en/service_management/incident_management/incident_settings/property_fields.md +++ b/content/en/service_management/incident_management/incident_settings/property_fields.md @@ -57,6 +57,10 @@ You can define new fields of any of the following field types: **Datetime** : Accepts any datetime. Values are stored in UTC and are parsed and formatted using the user's local timezone. +### Field names + +A field's name is a snake-case identifier used in [search and analytics queries][12], [Workflow automations][13], and APIs. Its display name is a user-friendly label that determines how the field appears in an [incident's overview page][1], an [incident's timeline][10], and the [incident declaration modal][11]. + ### Required at declaration If you mark a field as "Required at Declaration," users are required to enter a value when declaring incidents. This option does not affect Datadog Workflow automations or API requests. @@ -83,4 +87,8 @@ In Incident Management Analytics, number fields appear as measures that can be g [6]: /getting_started/tagging/using_tags/?tab=assignment#metrics [7]: /dashboards/ [8]: /notebooks/ -[9]: /service_management/incident_management/incident_settings/notification_rules \ No newline at end of file +[9]: /service_management/incident_management/incident_settings/notification_rules +[10]: /service_management/incident_management/investigate/timeline +[11]: /service_management/incident_management/declare +[12]: /service_management/incident_management/incident_settings/property_fields#custom-fields-in-search-and-analytics +[13]: /actions/workflows/