Custom ticket fields

Custom ticket fields allow you to collect more information when your users submit a ticket. Fields can be seen in your user portal, admin panel or both. They can be optional, required or editable by either the user or agent or both.

Setting up

Go to Settings > Ticket > Fields.

Here you can deactivate and reactivate some of the system fields. You can add, manage and customize your own fields.

Types of fields

  • Single-line text
  • Multi-line text
  • Dropdown
  • Checkbox
  • Checkbox list
  • Number (for whole numbers)
  • Decimal (for both decimal fractions and whole numbers)
  • Date
  • Regular Expression (JavaScript regular expressions are supported)

Display options

Custom fields have separate display options settings for agents and users. Here is how they work.

Agents

  • Visible - Field is visible to agents.
    When adding a new ticket, this field won't show up unless it is also Editable. Agents will see the field in an existing ticket as long as it's editable or contains a value.
  • Editable - Field can be filled in by agents when they create or edit tickets.
  • Required - Field must not be blank when agent submits ticket as Solved. As long as the ticket isn't submitted as Solved, agents can freely reply to and update tickets without being asked to fill in required fields.

Ticket with an empty required field can be marked as solved with a trigger or automation (if you have one).

Users

  • Visible -¬†Field is visible to user when viewing ticket in the user portal.
    This field won't appear in the Submit a Request form, unless it is also Editable. Users will see this field in their profile page as long as it has a value or is Editable.
  • Editable - Field can be filled in by the user when submitting a ticket. Users can't change it later on.
  • Required - Field must not be blank when user submits the ticket.

Adding a custom field

  1. Click Add Field.
  2. Select field type.
  3. Give it a title. The same title will appear in the user area as well as in agent's ticket view.
  4. Set field display options for agents and users.
  5. Configure additional field options if available (depends on field type).
    • Time-saving tip: If you're adding a Dropdown or Checkbox List field, pressing enter after typing in an option creates a new option. Click X beside the field to remove an option.
  6. Click Save.

Disabling and deleting fields

If you disable a custom field, data from the custom field is preserved but not displayed in ticket / user view. The field will be displayed again (according to field settings) if you re-enable it.

If you delete a custom field, all its data gets erased for good.

The same is true if you delete or rename an option in a Dropdown or Checkbox List field. That option gets removed and unselected if it was previously selected.

Tips

Reorder fields via drag'n'drop. Their order in the settings page is how they'll show up for agents and users.

Custom fields are not saved to drafts. Make sure you submit your ticket to save changes to custom fields.

Regular Expression examples

Here are some examples of regular expressions you can use.

Regular Expression Description Valid Values
^[0-9]{3}-[A-Z]{4}$

Three digits, hyphen, four uppercase letters

567-KJFD
002-ZIDF

^[A-Z]{2,6}$

From two to six uppercase letters

TU
DFJR
VFEHFJ

^[0-9]{3}-[0-9]{2}-[0-9]{4}$ US Social Security Number

654-45-6789

Was this article helpful?
0 out of 0 found this helpful