Suite | Team, Growth, Professional, Enterprise, or Enterprise Plus |
Support | Team, Professional, or Enterprise |
Custom fields provide a way to store additional information about tickets, users, and organizations. The custom fields are visible to all team members, and can be used in business rules and reporting.
Accessing the custom fields pages
The custom field pages are located in Admin Center and provide a list of existing custom fields. You can also see information about each field, search, filter, see the status of the fields, add new fields, edit the order of fields, and export a CSV of your custom fields.
- In Admin Center, click
People in the sidebar, then select Configuration > User fields.
- In Admin Center, click
Objects and rules in the sidebar, then select Tickets > Fields.
- In Admin Center, click
People in the sidebar, then select Configuration > Organization fields.
-
In Admin Center, click
Objects and rules in the sidebar, then select Custom objects > Objects.
When creating or editing a custom object, use the Fields tab to manage the object's custom fields.
Reordering custom fields on the fields pages
- Custom user fields ordering determines the order that your active custom user fields are displayed in user profiles.
- Custom organization fields ordering determines the order that your active custom org fields are displayed in organization profiles.
-
Custom ticket fields ordering affects how fields are ordered on the
business rules pages in Admin Center and when tickets are bulk updated in
the Agent Workspace. If your account has a single ticket form, reordering
custom fields on this page also reorders the fields on your form. Reordering
ticket fields doesn’t change the order in which they appear in a ticket if
your account has access to multiple ticket
forms.
For example, let’s say you have a custom field named "US region" and you reorder your ticket fields so that this field appears at the top of the Ticket fields page. When you create a trigger, and other business rule, this field will appear first in the list of custom fields in the Conditions drop-down. And, if you bulk update tickets, the position of this field is also affected.
As shown here when creating triggers and bulk updating tickets:
To change the order of custom user fields
- Open the custom fields page for tickets, users, or organizations.
- Click Actions and select Edit order.
- Click and drag the rows into the order you want or use the arrows on each row to move them up or down in the list.
- Click Save.
Exporting a list of your custom fields
If you want to use your custom field data in another app, you can export it to a comma-separated-values (CSV) file.
To export your custom fields
- Open the custom fields page for tickets, users, or organizations
- Click Actions and select Download CSV.
Your field data is exported and stored in the downloads folder of your computer.
15 comments
Kelsey Baines
I have created a new numeric custom field called Delivery Number (ID:34906138114061)- I want to pull the value of the field into the body of a comment using a macro on the ticket. Can someone please provide the code I would need to use on the macro with the ID listed above?
Can I also please get confirmation if the user must first enter the Delivery Number first (does the ticket need to be saved) and then select the Macro for the Delivery Number to be entered into the comment section - Or if the user selects the Macro and then enters the delivery number value ino the custom field, will the comment update with the value?
0
Robson Rodrigues
Is there a way to populate custom fields via the API while bypassing mandatory field requirements?
0
Gabriel Manlapig
Hi David,
This should populate immediately after saving the new field values. If you just added new field values to a custom user field, you may need to refresh your web browser / page in order to see the changes.
We hope that helps. Thank you!
0
David Oehler
In Zendesk Admin Center, when adding more Field Values in a custom User Field, how long should it take for the updates to show up in the Agent View? Is it automatic or is there a manual step required to publish/update? The User Field was previously created, but the new Field Values are not showing in the Agent view.
0
Gabriel Manlapig
Hi Ann,
We hope you're having a great day! Upon checking, you've already submitted another ticket and are currently in touch with one of our customer advocates. They recommended using this placeholder instead:
{{ticket.assignee.custom_fields.booking}}
We recommend keeping the conversation going by replying to the ticket if you have any more questions or need further clarification. Thank you!
0
Ann Babler
I am trying to create a Macro for our Agents to insert their bookings link. {{ticket.assignee.custom_fields.booking.title}} seems like it would be the correct format but it just comes up blank. Is there another way to do this? Field key is booking
0
Jupete Manitas
But we wanted share the community tip with everyone - Turning nested field options into usable placeholders with dynamic content.
0
Edzi Melodias
When using custom fields as placeholders, is there a way we can select which nested field to be displayed when using the macro? i.e.
Camera::Camera 1
Camera::Camera 2
When a macro is used for this custom field, it would only show Camera1/2? Thanks!
0
Bree Lewis
Can custom fields be marked as read only? We have an integration with SFDC and we don't want the agent to have the ability to edit these fields.
0
Gabriel Manlapig
Here's an article that provides an explanation as to the effect of altering or deleting a dropdown field values.
Understanding how creating, deactivating, or deleting ticket fields impacts tickets
I hope that thelps. Thank you!
0
Sign in to leave a comment.