Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Plan requirement: This feature requires an On-call Standard or higher subscription. Learn more
Custom fields extend incident description information. Flashduty On-call supports integrating most common alert systems, displaying pushed content in Labels. But you may need to record additional information, such as manually marking whether an incident is a false alarm. Custom fields are designed for this purpose.

​
Use Cases

Flexible Definition

Create multiple custom fields, define names, types, options, and default values. Supports text, single-select, multi-select, checkbox types

Information Association

Associate incidents with business data like affected systems, geographic location, related customers, whether it’s a false alarm, etc.

Filter and Categorize

Filter and categorize incident views by custom fields, create common filters to efficiently organize and handle incidents

​
Field Definition Example

Custom Fields List

​
Incident Information Association

Set Custom Fields

​
Filter View by Field

Filter by Field

​
Configuring Fields

​
Creating Fields

An account supports creating up to 15 custom fields.
1

Enter Configuration Page

Go to Console Incident Management → Custom Fields
2

Create Field

Click Create Custom Field, enter the following information:
ConfigurationDescriptionConstraints
Field NameIdentifies the field in API, cannot be modified after creation1-40 characters; letters, digits, and underscores only, and cannot start with a digit (regex: ^[a-zA-Z_][a-zA-Z0-9_]{0,39}$)
Display NameShown on incident details page, can be modified after creation1-40 characters
Field DescriptionHelps incident handlers understand and use this fieldUp to 200 characters, optional
3

Select Field Type

TypeDescription
TextPlain text input, max 3,000 characters
Single-selectDropdown with single selection, max 20 options, each up to 200 characters
Multi-selectDropdown with multiple selection, max 20 options, each up to 200 characters
CheckboxCheckbox toggle
4

Complete Creation

Set options and default values as needed, click Submit to finish.
For single-select and multi-select fields, the default value must be one of the options currently defined on the field. If you delete or modify an option, update the default value accordingly — otherwise the field cannot be saved.
If a field has a default value set, the system automatically writes that field when incidents are created. Note that field configurations only affect new incidents, not existing ones.

​
Updating Fields

Only the following can be updated:
  • Display name
  • Field description
  • Field options (single-select and multi-select types only)
  • Default value
Field updates only affect new incidents, not existing ones.

​
Deleting Fields

You can initiate deletion from the console at any time.
Deletion is a time-consuming operation. The system scans historical incidents and asynchronously deletes field associations. You cannot create a field with the same name until deletion is complete.

​
FAQ

Please confirm whether the field type you want to search is Text type. To ensure system stability, searching text type fields is currently not supported.
If you need to filter incidents by field value, we recommend using Single-select or Multi-select types.

Search and View Incidents

Learn about incident filtering and viewing features

Handle and Update Incidents

Learn about incident handling workflow