> For the complete documentation index, see [llms.txt](https://help.join.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.join.com/review-candidates/tags.md).

# Tags

Add and remove tags on candidates, create tags as you go, and rename, recolour or delete your company's tags on the Tags page in Settings.

Tags are coloured labels you assign to candidates to keep them organised, for example `Great fit`, `Needs follow-up`, or `Backend`. You can use them to group candidates by fit, status, or any criteria that matter to your hiring process, and then filter by them later.

Tags belong to your company account. Every tag you create is available to all team members, across all jobs.

***

## Add tags to a candidate

You can add tags to candidates from the candidates list, a job's applications, the talent pool, the candidate profile, and the screening view. In each place, tags open in the same dropdown:

* Tags already assigned to the candidate are checked and appear at the top
* All other tags follow in alphabetical order
* You can type in the search field to find a tag quickly

### From the candidates list

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FASIvpM9WQnV3qAJbnEGA%2Fimage.png?alt=media&amp;token=9845a87c-fa5a-49dc-a898-651a26b6c089" alt=""><figcaption></figcaption></figure></div>

1. Go to `Candidates` and select `Active`, `Hired`, or `All`.
2. Click the tag area in the `Tags` column next to the candidate.
3. Check the box next to each tag you want to add.

The dropdown stays open, so you can add several tags in one go. Click anywhere outside the dropdown to close it.

To add tags to multiple candidates at once:

1. Select candidates using the checkboxes.
2. Click `Add tags` in the action bar at the bottom of the page.
3. Select one or more tags and save.

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FregqJ4YWTXMd4G3i7xLp%2Fimage.png?alt=media&amp;token=c4a9f9aa-27a2-48a7-a7e7-3a19d91f0104" alt=""><figcaption></figcaption></figure></div>

### From a job's applications

1. Open a job from `Jobs` and go to its applications.
2. Click the tag area on the candidate card (cards view) or in the `Tags` column (table view). You can also open the `...` menu on the card and select the tag option.
3. Check the tags you want to add.

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FAaZK1ch8RM4HXOVqFWXM%2Ftags.jpg?alt=media&amp;token=0c16a1a8-78b0-436d-b2c5-01e5a84bb4fc" alt=""><figcaption></figcaption></figure></div>

To bulk add tags, select multiple candidates using the checkboxes and click `Add tags` in the action bar.

### From the talent pool

Click the tag area next to the candidate and check the tags you want to add. Bulk tagging isn't available in the talent pool.

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FDvqq8KczNAtavODL2jsQ%2Fimage.png?alt=media&amp;token=4a7d1c67-00e6-4a55-a72d-e6e4fd5dcee4" alt=""><figcaption></figcaption></figure></div>

### From the candidate profile

1. Open a candidate profile and navigate to the right-most panel.
2. In the `Tags` section, click `+` (or click an existing tag).
3. Check the tags you want to add.

If a candidate has more tags than fit in the section, a count pill shows how many more there are. Hover over it to see the rest.

***

## Create a new tag

{% hint style="info" %}
Only `Standard` users and `System Admins` can create new tags. `Limited` users can add and remove existing tags but can't create new ones.
{% endhint %}

If the tag you need doesn't exist yet, type its name in the search field and click `+ Create`. The new tag is created, assigned to the candidate, and given a random colour. You can change the colour later in [Settings](#manage-tags-in-settings).

Tag names must be unique and can be up to 70 characters. Names aren't case-sensitive, so `Strong fit` and `strong fit` count as the same tag.

***

## Remove tags from a candidate

1. Open the tag dropdown from the candidates list, a job's applications, the talent pool, or the candidate profile.
2. Uncheck the tag you want to remove.

Removing a tag from a candidate doesn't delete the tag itself. It stays in your tag list, even if no candidates have it anymore. To remove a tag from your account completely, [delete it in Settings](#delete-a-tag).

***

## Manage tags in Settings

The `Tags` page in Settings is where you see and manage all of your company's tags in one place. You can create, rename, recolour, and delete tags here, and changes apply everywhere the tag is used.

To open it, go to `Settings` and select `Tags` under `Templates`.

{% hint style="warning" %}
Only `Standard` users and `System Admins` can see and use the `Tags` page. This is controlled by the `Manage tags` permission. See [Member management](https://help.join.com/manage-your-team/member-management.md) for an overview of company roles.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2F1Ex1AlnlN2Ad7H8o29qx%2Fimage.png?alt=media&amp;token=193dcde1-32b8-47f0-9aba-0a370b8fafe1" alt=""><figcaption></figcaption></figure></div>

The table shows each tag with:

* `Candidates`: how many candidates currently have the tag
* `Last applied`: when the tag was last added to a candidate
* `Created`: when the tag was created

The table is sorted by `Created`, newest first. Click any column header to sort by that column instead. Use the `Search` field to find a specific tag.

### Create a tag

1. Click `+ Create tag` in the top-right corner.
2. Enter a `Name` (up to 70 characters).
3. Choose a `Colour`: `Grey`, `Blue`, `Green`, `Orange`, or `Red`. A random colour is preselected.
4. Click `Save`.

Tags created here aren't assigned to any candidates yet.

### Edit a tag

1. Hover over the tag's row and click `...` under `Actions`.
2. Select `Edit`.
3. Change the `Name`, the `Colour`, or both.
4. Click `Save`.

The change applies to every candidate with that tag. Existing activity log entries also show the updated name.

### Delete a tag

1. Hover over the tag's row and click `...` under `Actions`.
2. Select `Delete`.
3. Click `Delete tag` to confirm.

{% hint style="warning" %}
Deleting a tag removes it from all candidate profiles. Check the `Candidates` column first to see how many candidates will be affected. A deleted tag cannot be restored.
{% endhint %}

When you delete a tag:

* It's removed from every candidate who had it
* Each affected candidate's activity log shows that the tag was removed because it was deleted in Settings
* It's removed from any tag filters you've applied

***

## Tips for using tags

* Filter by tags in the candidates list or the talent pool to quickly find candidates with a specific label.
* Agree on naming conventions with your team so filters stay useful. For example, use `Technical fit` consistently instead of several variations like `Tech fit` or `Technically good`.
* Use colours to group related tags, for example green for positive signals and red for concerns.
* Review the `Tags` page from time to time. Tags with 0 candidates associated are good candidates for clean-up.

***

## FAQs

<details>

<summary>Why can't I create new tags?</summary>

Only `Standard` users and `System Admins` can create tags. If you have the `Limited` role, you can add and remove existing tags, but the option to create a new one won't appear. Ask a `System Admin` in your account to create the tag or change your role.

</details>

<details>

<summary>Why is a tag still in my list after I removed it from all candidates?</summary>

Tags no longer disappear automatically when they're removed from the last candidate. This lets you keep tags you plan to use again. To remove a tag from your account, delete it from the `Tags` page in Settings. See [Delete a tag](#delete-a-tag).

</details>

<details>

<summary>Why can't I see the Tags page in Settings?</summary>

The `Tags` page is only available to `Standard` users and `System Admins`. If your role was changed while you were on the page, you'll see a message that you no longer have access. Contact a `System Admin` in your account if you need access.

</details>

<details>

<summary>Why do my existing tags suddenly have colours?</summary>

When tag colours were introduced, every existing tag was given a random colour. You can change any tag's colour from the `Tags` page in Settings. See [Edit a tag](#edit-a-tag).

</details>

<details>

<summary>Why was one of my tag names shortened?</summary>

Tag names are limited to 70 characters. Any existing tag with a longer name was shortened to 70 characters. You can rename it from the `Tags` page in Settings.

</details>

<details>

<summary>Why do I get "This name already exists" when creating a tag?</summary>

Each tag name can only be used once in your account, and names aren't case-sensitive. Search the `Tags` page for the name to find the existing tag, then use or edit it instead.

</details>


---

# 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://help.join.com/review-candidates/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.
