> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/product/features/console/site-tags.md).

# Site tags

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). [Source on GitHub](https://github.com/snapfix/docs/blob/main/product/features/site-tags.md).
{% endhint %}

**Site admins** keep the **tags** a site uses, sorted into **tag folders**. On the web, in the Site Console's "Tags" tab, they create, edit and delete folders, add, rename, copy, move and delete tags, merge folders, import tags from a CSV file, and choose the groups each folder is enabled in. Each group's tasks then offer the tags of the folders enabled for it. The apps have no site-wide tag page: each group manages its own tags in its [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md).

## Rules

* The Tags tab shows to role "Admin". Its route also admits group admins, who can open it by its address ([Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md)).
* Folder controls need the site permission "Edit Tag Folders"; tag controls and the tag editor need "Manage Tags". Both are set per person in [Site users](https://docs.snapfix.com/product/features/console/site-users.md) and read from the site stored as current ([Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#layout)).
* After a [Site details](https://docs.snapfix.com/product/features/console/site-details.md) save, or after a site is picked from a multi-site list, the stored site carries these permissions as off, so the controls hide until the site list reloads.
* A folder name is required on create and holds up to 20 characters; its description up to 255. On edit the name can be cleared, and the server keeps the old one ([Tag folder](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#tag-folder-create-and-edit)).
* A tag name holds up to 100 characters and is unique in its folder. A name that already exists in the folder is skipped with no message. The inline "Add New Tag" field, used with Enter or "+", has no length limit ([Tag](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#tag)).
* Deleting a folder permanently removes all its tags, after "Deleting this tag folder will permanently remove all its tags. Are you sure you want to continue?". Deleting several folders first says how many folders, tags and tasks are affected ([Actions](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#actions)).
* In the editor ("Merge Tags", which opens "Edit Tags / Merge Tag Folders"), tags are dragged, copied, pasted and deleted between two folder panels. Deleted tags are removed from every item that uses them. Nothing changes until "Save", which applies the deletes, then the adds and renames, then the moves ([Dialogs and sheets](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#dialogs-and-sheets)).
* Merging two folders keeps one copy of each tag, and the merged folder is enabled in every group that had either folder ([Dialogs and sheets](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#dialogs-and-sheets)).
* The editor's "Cancel" always asks to discard changes, even when nothing changed, and both answers close it and drop the changes.
* The CSV import takes one column, one tag per row. Blank, too long and repeated names are flagged before "Create"; tags that already exist in the folder are skipped with no count ([CSV upload](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#csv-upload)).
* A folder's "Groups" card switches it on per group, or in every group; "Save" sends only the changed groups. The card lists every live task group of the site ([Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#layout)).
* A group can also choose its folders, and mark some as required for its tasks, in its own settings; the server does not check the requirement ([Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md#settings-drawer-web)).

## Flow

```mermaid
flowchart TD
    tab["Tags tab"] --> folder["Add or pick a tag folder"]
    folder --> fedit["Edit or delete the folder"]
    folder --> tags["Add a tag: type and Enter, or CSV upload"]
    folder --> editor["Merge Tags editor: drag, copy, paste, delete, merge"]
    editor --> save["Save: deletes, then adds and renames, then moves"]
    folder --> groups["Switch the folder on per group"]
    groups --> gsave["Save sends the changed groups"]
```

## Platforms

| Capability                            | Web                                         | iOS                          | Android                      |
| ------------------------------------- | ------------------------------------------- | ---------------------------- | ---------------------------- |
| Site-wide tag folders and tags        | Yes, Tags tab                               | No                           | No                           |
| Merge folders, CSV import             | Yes                                         | No                           | No                           |
| Choose the groups a folder is used in | Per folder, and per group in Group settings | Per group, in Group settings | Per group, in Group settings |
| Manage a group's own tags             | Group settings                              | Group settings               | Group settings               |

## Screens

* [Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md): the Site Console tab (web).
* [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md): each group's tag folders and tags.

## API and data

* [Tags API](https://docs.snapfix.com/engineering-reference/api/tags.md): the folder, tag, group, merge and CSV calls. The page uses `read_parent_tag_folders`, `read_folder_tags`, `read_folder_groups`, `save_tag_folders`, `delete_tag_folder`, `save_folder_groups`, `save_tags`, `delete_tags`, `move_tags` and `merge_tag_folders`, and `POST /v1/app/tag-headers/delete/preview` and `/delete/multi` for deleting several folders.
* Tables: [`tPri_TagHeader`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_tagheader.md) (tag folders), [`tPri_Tag`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_tag.md) (tags), [`tPri_JobTag`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_jobtag.md) (tags on tasks) and [`tPri_BusinessTagHeaderRule`](https://docs.snapfix.com/engineering-reference/db/tables/tpri_businesstagheaderrule.md) (which groups use a folder, and whether they require it).

## Depends on

* [Site users](https://docs.snapfix.com/product/features/console/site-users.md): the "Manage Tags" and "Edit Tag Folders" permissions.
* [Groups](https://docs.snapfix.com/product/features/groups/groups.md): the groups that use each folder, and their settings.
* [Tasks](https://docs.snapfix.com/product/features/tasks/tasks.md) and [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md): the tags on tasks, and the tags a group requires.
* [Multi-select](https://docs.snapfix.com/product/features/tasks/multi-select.md): changing the tags of many tasks at once.
* [Snapfix Recommends](https://docs.snapfix.com/product/features/ai/snapfix-recommends.md): "Restrict to My Tags" keeps suggestions to existing tags ([Site details](https://docs.snapfix.com/product/features/console/site-details.md)).

## Edge cases

* **No folders, or an empty folder:** "No tag folders found", and "No tags found" in an empty folder ([States](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md#states)).
* **Deleting:** deleting a folder or a tag changes every task that uses it.
* **A failed folder delete:** after the API's message, an alert shows the raw key "TAG.ERROR\_DELETING\_FOLDER".
* **Texts:** the editor's hint reads "Selete a second tag folder…", and the bulk delete confirmation can show raw HTML tags as text.
* **A folder switched off in every group:** it stays on the site and can be switched on again.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/product/features/console/site-tags.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
