Ticket Custom Fields, which are also referred to as Ticket Attributes, identify specific ticket traits that can help users create granular filters to help create granular workflows. 

Examples of Ticket Custom Fields would be: Ticket [Status] and [CSAT Score]

Ticket Custom Fields can be used within:

This article will teach you how to add Ticket Custom Fields/Ticket Attributes.

The functionality to add Ticket Custom Fields is limited to users with the Admin role.

Go to Settings > Integrations > scroll down to the [Integration Settings] section.

These settings will default to the helpdesk you have integrated (ex. Zendesk, Salesforce, Intercom) and [Ticket Custom Field]. If multiple helpdesks are integrated, on the [Select Helpdesk] dropdown, choose the helpdesk with the custom field you want to add.

This will now bring up two selectors: 

These options are slightly different depending on the integration, and for this case, we will describe how the options work if the user is integrated with Zendesk.
​
The first selector Select Field Type has 2 options, standard, and custom. These correspond to default ticket fields and your custom Zendesk fields special to your Zendesk account, respectively.  

The second selector Select Field has many options; this is where you select the actual field you want to import.

After you click on the "Add Ticket Custom Field" button, a row will be generated on the Ticket Attributes page.

MaestroQA's manual ticket creation features allow users to manually create tickets in MaestroQA when they don't have a helpdesk that can be synced from. Custom ticket attributes can also be manually defined and attached as metadata to those tickets. Follow these steps to create your own custom ticket attributes:

To manually create a custom ticket attribute, navigate to the "Ticket Attributes" page within MaestroQA.

Click the "Add Attribute" button to add a new custom attribute.

In the "Add Attribute" dialog, you'll need to specify a "display name" and label for your attribute.

Attribute label:

- must be unique (no other attributes may use this value)

- cannot be modified after creation

Attribute name ("display name"):

- should be a short, descriptive name that accurately represents the metadata you're adding - for example, if you're adding a custom attribute to track ticket urgency, you might name it "Urgency"

- does not have to be unique

- can be changed at any time, from the "Custom Attributes" table on the Ticket Attributes page

Next, you'll need to set the type of attribute you're adding. There are several types to choose from, including text, date, number, and boolean. Choose the type that best fits the metadata you're adding.

Click "Add" to save your new attribute. Newly created attributes will be displayed at the bottom of the Custom Attributes table.

*If an attribute with the same label already exists, you will see an error notification in the top right corner of the screen.
​
​*Custom attributes that are created manually can be deleted by clicking the trash icon next to them in the Custom Attributes table.

Once you've added your custom attribute, you can start using it when you create tickets from the Tickets API and via the Manual Ticket Upload feature.

To learn more about customizing these newly imported Ticket Attributes and making them available in different parts of the app, check out this article 👉 "Where are my Custom Ticket Attributes."