When adding or removing ticket fields from a Zendesk ticket form with existing conditional logic, it’s important to proceed carefully to avoid disrupting any workflows, breaking conditional rules, or encountering unexpected errors.
Here’s an example of a common error that may occur if you try to remove a ticket field currently used in the form’s conditional logic configuration.
This article will cover the following topics:
- Review Existing Conditional Logic
- Add a New Ticket Field
- Remove a Ticket Field
- Test the Form and Conditional Logic
- Tips for Managing Conditionality
Step 1: Review Existing Conditional Logic
- Go to Admin Center > Objects and Rules > Ticket Forms.
- Move the cursor over the ticket form that you want to add conditions to, then click the options menu ⋮ on the right side and select Conditions.
- Check the conditional logic that’s currently applied. Take note of the following:
- Which fields are dependent on each other and how conditions are set to display or hide fields based on different criteria.
- Which fields are visible to agents or end-users.
- Take screenshots if you need so you can re-build any conditional logic required when editing a ticket field.
Step 2: Add a New Ticket Field
- Create the new field if it doesn’t already exist:
- Go to Admin Center > Objects and Rules > Fields.
- Click Add field, and choose the type of field (e.g., dropdown, text, etc.).
- Configure the field properties, then Save it.
- Edit the ticket form to add this field:
- Go to Admin Center > Objects and Rules > Ticket Forms.
- If your plan has multiple ticket forms, click the ticket form you want to edit.
- Note: The ticket form opens in edit mode
- If your plan has a single ticket form, edit your form by reordering the custom fields.
- If your plan has multiple ticket forms, click the ticket form you want to edit.
- Add your field - type the name of a ticket field into the search field or use the filters to find it.
- Once added, the new field will appear on the form for all users unless conditionality is applied.
- You can then drag and drop the field into the right position on the form.
- Go to Admin Center > Objects and Rules > Ticket Forms.
- Click Save.
- Add conditional logic for this new field (if required):
- Go to Admin Center > Objects and Rules > Ticket Forms.
- Move the cursor over the ticket form that you want to add conditions to, then click the options menu ⋮ on the right side and select Conditions.
- In the Conditions section of the ticket form, add new conditions if you want this field to only display under certain circumstances.
- Specify the trigger conditions, such as ticket status or group assignment, that will make the field visible or hidden.
- Go to Admin Center > Objects and Rules > Ticket Forms.
- Save the changes after configuring conditional logic for the new field.
Step 3: Remove a Ticket Field
- Review Conditional Dependencies for the Field You Want to Remove
- Check if other fields or conditions rely on this field. Adjust or delete any conditional logic that includes this field before removing it.
- Refer to Step 1 for guidance on checking conditional dependencies.
If the Field Is Used in Conditional Logic:
- Update Conditional Logic
- Remove any conditional rules related to the field by deleting them from both agent and end-user logic sections.
- Save the changes after updating the conditional logic.
- Remove the Field from the Form
- In the ticket form’s edit mode, locate the field you want to remove and click the X beside it to take it off the form. The field will then move to the Available fields box on the right.
- Save the form to apply the changes.
If the Field Is Not Used in Conditional Logic:
- Remove the Field from the Form
- In the ticket form’s edit mode, find the field you want to remove and click the X to take it off the form. It will appear in the Available fields box on the right.
- Save the form after making these changes.
Step 4: Test the Form and Conditional Logic
- Test the form in a ticket to ensure the new field and any conditional logic works as expected for both the agent and end-user (if applicable).
- If you find any issues, return to the Conditions section to troubleshoot and adjust settings.
Tips for Managing Conditionality
- Document Changes: Note the existing conditions before making adjustments, as complex conditional logic can be hard to reverse. Screenshots can be very handy!
- Incremental Testing: Test after each field addition or removal to catch issues early.
- Avoid Overlapping Conditions: Ensure conditions are not overlapping, as this can lead to unexpected visibility issues on fields.