Creating new custom ticket fields
When you create new custom ticket fields, you are adding the option to capture additional information in each ticket.
For all tickets, regardless of status, the new ticket field appears on the ticket form in the agent interface. It displays a null '-' or empty value depending on the type of custom field.
The newly created ticket field alters all tickets with a status less than closed when a value is added to the field. If the new field is added to a ticket form, but data is never added to the field, it won't appear in the ticket audit endpoint. This is true for all tickets with custom fields but no data added, regardless of when the fields are created.
Altering drop-down field options
Drop-down fields display the same behavior as other custom ticket fields in tickets, reporting, and the API. However, drop-down field options can be changed and deleted. It is important to note drop-down field options are directly connected to their assigned tag. For example, in the image below, the drop-down field value redhas the tag color_red.
Changing drop-down field options
Changing the field value but not its tag effectively replaces the old field option. Reusing tags for new fields isn't recommended because it replaces the existing value on all tickets, including closed and archived tickets, and can skew reporting.
The inverse is also true. If you want to edit an existing drop-down field value, you can ensure the same is replaced in all instances by keeping the same tag. This is useful for reporting if you only want to report on a new value, not a new tag.
If you have any of these objects that use the custom field being edited, the tag must remain the same for the object to continue functioning. If the tag no longer exists for a given field value, the object will return an error.
Deleting drop-down field options
- Closed and archived tickets display a yellow caution icon with a
Missing field value warning next to a deleted value selected
in a drop-down field.
- Unclosed tickets (including solved) replace the deleted value with a null '-' value. No error is displayed in the ticket.
The tag from the drop-down field isn't deleted from the ticket tag field, so you can still use the tag in your reports. This also means that if you create a new drop-down field option with an identical tag, the ticket field will change back to the selected value. See Reporting with custom fields.
Deactivating custom ticket fields
Any data lost from a deactivated field can be recovered again by reactivating the field. After reactivation, the field is available in the ticket view of the agent interface again.
For all tickets, regardless of status, deactivating a ticket field removes it from the agent interface.
The data in a deactivated ticket field remains stored in the ticket audits endpoint.
Deleting custom ticket fields
If you delete a custom ticket field, you won't be able to recreate or recover the field or its data. If you'd like to preserve the field data, deactivate the field instead.
For all tickets, regardless of status, deleting a ticket field removes it from the agent interface permanently.
When a custom field is deleted, its data (including the field ID), is saved in the API. The ticket audits endpoint tracks and stores every change to a ticket, including custom ticket field data after the field itself is deleted. This is the only location deleted custom ticket field data is stored.