The Tag Locker app helps control the use of tags within tickets, limiting agents to a pre-defined set of tags and giving admins more granular control of tags.
This article includes the following topics:
Installing the app
- In Admin Center, click the Apps and integrations icon (
) in the sidebar, then select Apps > Zendesk Support app
- Click Marketplace at the top of the page and then enter "Tag Locker" in the Marketplace search bar.
- Double-click on the Tag Locker app icon, and click Install.
- In the Installation section, enter a name for the Tag Locker app, enable group and role restrictions if required. These configuration options are also available after installation by navigating to Admin > Apps > Manage.
- In the Tags for agents field, list any tags that agents are allowed to add to a ticket. Separate each tag with a space.
- In the Tags for admins field, list any tags that only admins should have access to add and remove. Admins also automatically have access to any tags in the Tags for agents field, so do not duplicate those tags here. Separate each tag with a space.
- Tags available by group can be enabled. This allows groups to see only their assigned tags. To enter tags by group, use the same format as Required tags to solve by group, detailed in step 7, below.
- Required tags to solve by group can be enabled. This allows certain tags to be required to solve a ticket, specific to certain groups. To enter tags by group, use the following format of group names in quotes and tag names in quotes separated by a space.
{
"Group A": "TagA TagB TagC TagD",
"Group B": "TagB TagE",
"MyGroup": "tag6 extra_tag"
} - Select the Administrator override checkbox to allow administrators to add or remove tags to the Tag field on the ticket, regardless of whether they are listed in Tag Locker.
- Select the Hide native Zendesk tags checkbox if you would like to hide the native tag field completely.
- On the app details page, click Install.
Using the app
While working on a ticket, and agent or administrator can view the list of tags available to be added to the ticket in the Available tags field. They can also view any tags that are currently on the ticket in the Current tags field. If enabled in the setting, agents will only be able to see those tags available to their assigned group or groups.
An agent cannot remove admin tags from the ticket which are listed in the Current tags field. These are indicated with a padlock icon.
Note: Tag Locker overrides any rights related to adding tags that are part of a role under Admin > Manage > People > Roles.
To add and remove a tag
- Display the Tag Locker app on the ticket page by clicking the Apps button on the upper-right side of the page.
- In Available Tags, click the green plus icon next to the tag name to add it to the ticket. If an Administrator override has been enabled in the app settings, an admin can also add tags directly into the Tags box, whether or not they are listed as accepted by Tag Locker.
- In Current Tags, click the red X icon in the Current tags box remove a tag.
- Click Submit as... to save your changes.
Tags required to close a ticket
If the settings have been specified to enable required tags to solve, the agent will see a list of tags in the app that are required to solve the ticket. The app will block the agent from solving a ticket before those tags have been added.
Release notes
Version 2.1.2 - 2020-04-09
- Fixed an issue where the native Tags field was enabled by mistake for non Administrators after saving the ticket and choosing to stay on the ticket.
Version 2.2.0 - 2021-07-30
- Convert and incorporate paid features into the Free plan
10 Comments
Hello! Is there any way to get this app to show in the sidebar on the left instead of behind the "Apps" button on the right side of a support ticket?
Thanks so much for the quick answer!
I have a problem that whenever I input any information into the Tags available by group section, the app breaks... none of the tags become available. I can add tags to Agents section, and admin section, but nothing to the group section(s). I have reviewed the formatting and I am inputting it exactly as stated.
I have tested thoroughly. I honestly can't see what I could be doing wrong.
Any thoughts or advice?
Thanks
Sorry to hear about this trouble. I'll go ahead and create a separate ticket on your behalf so that we can further discuss and troubleshoot this issue you posted.
You may expect an email shortly with the ticket information.
Hello,
We use this app to restrict the editing of tags for agents. However, some of our agents have put actions relating to tags in their personal macros and this app seems to allow it. For example, one agent used "set tags" in a personal macro, and they successfully removed every locked tag on a ticket with the exception of one. Is this app supposed to allow agents to edit locked tags through macros? Is there any way to truly lock the editing of tags, even through macros?
Thank you
By using macros, your agents will be able to override the settings of the app.
The aim of the app is to avoid manual mistakes that could be made in a ticket, macros would not be included in this scenario.
Unfortunately, there is no way to truly lock the editing of tags.
I have a problem that whenever I input any information into the Tags available by group section, the app breaks... none of the tags become available. I can add tags to Agents section, and admin section, but nothing to the group section(s). I have reviewed the formatting, and I am inputting it exactly as stated.
We'll continue to assist you on the ticket you raised with us related to this issue, kindly check your email for updates. Thank you!
Hi All,
For anyone trying to solve the mystery of how to apply syntax for this, you need to put the complete list in the agents tag, then filter the list in the group values. For example:
and here's the body for you to copy and paste for ease:
{
"Tier 1": "Bug tier1tag",
"Tier 2": "Bug tier2tag",
"Tier 3": "Tier3"
}
Please sign in to leave a comment.