Forms & Fields
Built In Fields
Overview
Rootly comes with a series of built-in incident properties that are carefully selected to meet common incident characterization requirements. These properties are used to provide incidents with additional metadata so teams can dynamically trigger automations and run metrics reports based on these properties. Please see the Incident Properties page to learn more about them. You can access the Built-In Fields page by navigating to Configurations > Fields > Built-in-fields
Managing Built-In Fields
Enable/Disable Field
Only enabled fields are considered to be live fields - meaning they can appear on UI screens and be updated during incidents. Disabled fields are NOT usable during incidents and cannot be updated by workflows either. You can use the toggle switch next to the field name to enable/disable it.
Edit Field
You can edit a specific field by clicking on the edit icon on the right-hand side of the field. Once selected, you will see an Edit Form Field pane open. From here, you’ll be able to edit how this particular field appears in the forms.
ID
ID
This is an unique identifier for the form field. It is automatically generated for you upon field creation and cannot be edited. This
id will be used to reference the specific form field in API calls and Liquid syntaxes.Name
Name
This field is auto generated for built-in fields and can be edited. The name entered here will be the value that appears on user-facing forms. However, it will NOT alter the Liquid syntax used to reference this property.For example, if you set this field to
ENV, it will be reflected in the forms. However, when you go to reference it using Liquid syntax, it would still be {{incident.environments[0]}}.Field Type
Field Type
Depending on the built-in field being referenced, you can alter its field type. If the built-in field is an array of values (e.g. Services, Environments, etc.), you can change the field type to either a simple
Select or Multiple Select type. For example, if you want to enforce that users can only select a single Incident Type, then you can update the Incident Type field to be a Select field type.Not all built-in fields can have customizable field types. For example a checkbox field (e.g. Backfill Incident toggle, Mark as Triage toggle) can only be that type.Default
Default
Built-in fields can be configured to have a default value. For example, if you want all your incidents to default to
SEV4 for the Severity field, then you can set it here.Enabled
Enabled
Only enabled fields are considered to be live fields - meaning they can appear on UI screens and be updated during incidents. Disabled fields are NOT usable during incidents and cannot be updated by workflows either.You can use the toggle switch next to the field name to enable/disable it.
This is the same setting as the toggle described in the Enable/Disable Field section above
Display This Field in the Incident Details
Display This Field in the Incident Details
This switch allows you to display or hide the specific field on the Details section of the Incident Details page.
Hiding a field from being displayed in the Details section does not mean this field is turned off. It just means users cannot edit it from the UI.This is typically used when teams want to configure a custom flag that gets systematically set by workflows, not manually by users.