Tags
In the app: Settings → Tags
Needs the 'Manage Tags' permission.
The list of tags your team and the AI agent can put on conversations. Tags are used to sort, filter and report on conversations, and they are the only tags the AI agent can apply. A tag belongs either to every store in the organization or to the stores you choose for it.
Tag list
In an organization with one store, the page lists every tag. With several accessible stores, a "Store" picker appears. The page title names the chosen store, and the list shows the tags that store can use: its own and the ones shared with every store. A teammate limited to one store gets that store’s list without a picker. The page opens on the last store you worked on that you can still access, or the first available store.
Each row shows:
- the tag in its own colour, and the colour code next to it;
- where the tag came from, as a small badge:
- "Starter": one of the starter tags. Rename, recolour or delete it freely.
- "Used by your agent": set up with your AI agent's template, whose instructions apply this tag by name. Recolouring is safe. Renaming or deleting it stops the part of the agent that uses it.
- "Automatic": written by a feature of the product, such as the return portal or a status update, not by a person.
- "Yours": created by someone on your team.
- Older tags have no badge, because where they came from was not recorded.
- "All stores" on a tag that is shared with every store. This badge only shows when the page is limited to one store;
- the tag's description, or a "No description" chip. Without a description the AI agent has only the name to go on.
The pencil button edits a tag and the bin button deletes it.
When there are no tags, the page shows "No tags yet" with two buttons. "Add the starter tags" creates a ready-made set of 14 common support tags, such as "order-status", "return-request" and "refund-request", each with a description and a colour. Tags that already exist are skipped. With several stores, the starter tags are created for the store that is selected. "Create your own" opens the same dialog as "Create Tag".
"Create Tag" is disabled while the page is still loading your stores, and when that list could not be loaded; "Load stores again" retries. Until the stores are known, Squid cannot tell whether a new tag would belong to one store or to all of them.
Create or edit a tag
"Create Tag" opens the "Create Tag" dialog; the pencil button on a row opens "Edit Tag".
"Name" is required and can be up to 50 characters. Squid stores it in lower case with spaces at the ends removed. Two tags that apply to the same store cannot have the same name; the save is refused if they would.
"When to use it" is an optional sentence of up to 200 characters, for example "Customer is asking where their order is". The AI agent reads it when it decides whether the tag applies. A tag without one is a tag the agent has to guess about. On an existing tag the sentence can be changed but not removed: saving it empty keeps the previous text.
"Color" is the colour the tag shows in everywhere. Pick it with the colour picker or type a six-digit hex code such as #3B82F6. The preview next to it shows the tag as it will look.
"Create" or "Update" saves. "Cancel" discards.
Renaming a tag renames it on every conversation that carries it, in the stores the tag applies to. Reports and filters then show the new name for earlier conversations too.
Stores a tag applies to
You choose where a tag applies when you create it. It cannot be changed afterwards: the "Edit Tag" dialog has no store setting. To move a tag to other stores, create a new one.
"Apply to all stores" is ticked by default. The tag is then shared: every store can use it, including stores you add later.
Untick it to choose stores under "Stores". You can pick the stores the tag applies to, or switch to excluding stores, so the tag applies to every store except the ones you pick. At least one store must be selected.
A teammate whose access is limited to certain stores:
- cannot tick "Apply to all stores" and cannot exclude stores; they choose among the stores they can open;
- sees shared tags in the list but cannot edit or delete them. The same goes for a tag that excludes stores, or that applies to a store their account cannot open. The buttons are disabled and explain why: such a tag also changes stores their account cannot open.
Tags and the AI agent
The AI agent can only apply tags from this list. It sorts each conversation into the tags that exist for the conversation's store and cannot invent a new one. Adding a tag gives the agent a category it can use; deleting one takes it away. With no tags at all, the agent tags nothing.
For each tag the agent is given the name and the "When to use it" sentence. A clear sentence is what makes the agent pick the right tag.
When a store has more than 150 tags, the agent is shown the 150 that are used on the most conversations, with their sentences. The other tags still exist: your team can apply them, and the agent can still apply one when its instructions name it.
Tags that mark which side of an AI experiment answered a ticket are left out of the list shown to the agent.
Deleting a tag
The bin button asks for confirmation and then deletes the tag. This cannot be undone.
Deleting a tag:
- removes it from every conversation that carries it, in the stores the tag applies to;
- takes it out of the list the AI agent can choose from;
- for a tag marked "Used by your agent", stops the part of the agent's template that applies it by name. The confirmation says so.
Creating a tag with the same name later does not put it back on the conversations it was removed from.
Opening this page, and creating, editing and deleting tags, needs the 'Manage Tags' permission. The tag list itself is read with the 'View Conversations' permission, so everyone who can see conversations can see and use the tags in the inbox; someone with 'Manage Tags' but without 'View Conversations' cannot load the list on this page.