Skip to main content

Custom fields in live chats and email tickets

In this article, you will learn:

  1. Function of custom fields.
  2. How to add custom fields?
  3. How to download custom field report?
  4. How to capture custom field event on Studio?

1. Custom field in chat/ticket details

What are custom fields?

Custom fields can be added to tickets and are used to track business-specific information related to the customer like Order ID, Address, case details, etc. These are customized fields created by the admin to obtain additional details based on the industry. Custom fields enable your teams to add more information and further context about a case, which helps with better reporting and faster resolution.

  • As per the configuration, Custom fields can also be used as mandatory fields to Resolve/Transfer a chat/ticket.
  • 11 types of Custom fields are available for both live chats and email tickets.

Where can you find custom fields?

  • On the chat screen, expand Details. These are captured and passed to inbox via. Raise ticket node > Advanced options.

  • On the email detailed view screen, expand Ticket fields.


Who can update/view custom fields?

  • Inbox Admins can update/create and reorder custom fields for all the tickets. Agents can also search by custom field values if they are of the type short test, long text, email, number, phone and date.
  • Inbox Agent with access to edit that particular ticket will have permission to update these custom fields in the chat/ticket screen.
  • Inbox Supervisor can make changes to the custom fields on chat/email screen of any inbox agents they supervise.

2. Add custom fields

Follow the given steps to add new custom fields:

  1. Open Inbox > Settings.

  2. Search and select Custom fields.

  3. You can add custom fields for Chat and Email tickets. Select the required tab.

  4. Click +Add custom field.

  5. Add the required custom field details as per your requirement.

    • Custom field type: Select from the dropdown (explained below)
    • Field name: Type the name that must appear on the ticket details page.
    • Placeholder: This is the placeholder text that appears on the input bar on the ticket details page. Example: Enter phone number here, Type user name.
    • Options: If the custom field is of the type checkbox or radio button, you must enter the values in the options field by using enter key after each value.


Chat custom fields can have Short text and Long text as read-only fields (agents will not be able to edit this value). For example, if the customers Account number is a custom field, and the data entered by the customer must not be changed by the agents, it can be marked as read-only. This is not available for Email custom fields.

  1. Click Create. Once these fields are added, they will be listed on the ticket/chat details section on the right sidebar.

Re-order custom fields as per their priority

  1. Admins can drag and place the custom fields in the desired order. The custom fields will be displayed in the same order in the live chat or email ticket screen. Frequently used fields can be placed at the top for easy accessibility among a larger set of custom fields.

Types of custom fields

Custom fieldApplication
Short TextShort text like credit card number or order ID
Long TextLong text like Address, Detailed reason for complaint, etc
KeywordA single word text/ alphanumeric value
TagsPredefined tags like product category
CheckboxAgent can select multiple values that are listed. For example following values can be listed VIP customer, Sales, IT department, and the agent can select one or many of the relevant values
Radio buttonsAgent can select only one value from the defined list. For example Location, Store name
EmailAny email ID
NumberAny numerical /decimal value like an amount
PhoneContact number. Example: Customer’s emergency contact
DateAny date value. Example: Date of return of the item, Order placement date
HierarchicalWhen there are multiple levels of information, you can use this field

Hierarchical custom field (HCF)

HCF is utilized when dealing with multiple levels of information. For example, when a customer reports Charging broken, the agent can retrieve product details (Laptop/Mobile), assign it to a component (Charger), and find a resolution for that specific component.

  • You can have only four levels of HCF.
  • The option to mark as Required for ticket creation is not available for HCF.
  • These fields cannot be fetched from the Raise ticket node; hence, you cannot mark them as read-only.
  • All fields are marked as mandatory; therefore, all HCFs must be entered.


  • All levels of HCFs will be required on the ticket when marked as 'Required for transfer/close.



If you input a URL into Short/Long text custom fields, Inbox can automatically recognize it and facilitate one-click navigation for agents, simplifying the process compared to the tedious method where they have to manually select, copy, open a new tab, and paste the URL.

  • The URL won't be recognized if it doesn't have "www" in the web address.

Custom field limitation based on data types

You can only create the following number of custom fields for each data type:

Data typeNumber of custom fields allowed

Transfer/Resolve chat ticket by providing custom fields

For chat disposition with custom fields, you must mark the below checkboxes:

  1. Required to create ticket: A ticket cant be created if this field value is not entered.
  2. Required to transfer ticket: This value must be entered by the agent to transfer the ticket to another agent.
  3. Required to close ticket: This value must be entered by the agent if the ticket must be closed.

If these checkboxes are marked, the agent can not transfer or resolve the chat without providing a value for the custom field.


3. Download custom fields report

There is a column dedicated to each custom field in the chat archives report.

Custom field reports

To know how to download the chat archive report, click here.

4. Event to identify custom field inputs

When a custom field is updated in the platform, an event ticket-update is triggered, with the changeType set as change_custom_field. This event can be captured and utilized by activating it in Studio on Events.

For steps to create and activate events, refer to this article.

By identifying the ticket-update event and custom fields associated with it, you can develop Studio flows to address various use cases.

  • For example: When you have a custom field called "Order ID" in the Inbox and it gets updated, you can create an automation flow on Studio that triggers an action to update the corresponding order details on your website.

This can help keep the information synchronized and save time by avoiding the need for manual updates.