# Tags

Tags are short labels you add to records, such as **billing**, **churn-risk** or **q3**, to group
them in ways your workspace doesn't model otherwise. Every kind of record uses the same tags, the
same editor and the same **Tags** filter, so a tag means the same thing on a bug report, a task and
a knowledge base document.

<Availability permission="Tags: Create to add tags and Tags: Delete to remove them. On a list, also Update on the record." />

## Key concepts

**Tag.** A short label on a record. You can tag features, feature requests, bug reports, tasks,
sessions in Code, releases, knowledge base documents, notes, accounts, customer meetings and
support conversations, and internal meetings. Tags are shared across your workspace: the tags you
pick from are the ones already used on that kind of record.

**Spelling.** Every new tag is saved in lowercase, with hyphens between its words. See
[How tags are spelled](#how-tags-are-spelled).

**Suggested tag.** A tag Productmind proposes from the record's content. It isn't added until you
accept it, and it shows on the record's row as **+2 suggested**, for example.

**Rejected tag.** A suggestion you declined, or a suggested tag you removed after accepting it.
Productmind remembers it and doesn't suggest it again for that record.

## How tags are spelled

When you add a tag, Productmind saves it in lowercase, turns everything between words (spaces,
punctuation, symbols) into a single hyphen, and keeps it to 40 characters.

| You type | It's saved as |
| --- | --- |
| **Tech Debt** | **tech-debt** |
| **Billing & Payments** | **billing-payments** |
| **snake_case** | **snake-case** |
| **Q3** | **q3** |
| **Café** | **café** |

Letters with accents and letters from any alphabet are kept. A tag needs at least one letter or
number, so **!!!** can't be added.

Tags spelled the same way are the same tag. If a record already has **Billing**, adding
**billing** keeps **Billing** and doesn't add a second tag.

Tags added before this rule keep the spelling they were given: nothing renames them. If you pick
one of them for another record, such as **Billing & Payments**, it's added as **billing-payments**.
The tag editor lists each tag the way it will be saved, and shows **Add "billing-payments"** before
you add a new one that's saved differently from what you typed.

## Tags on a list

Every list that shows tags shows them the same way, in one chip toward the right of the row, just
before its date and status, so the tags line up down the list:
- one tag shows its name, such as **billing**;
- two or more show how many, such as **3 tags**;
- **+2 suggested** next to it means Productmind has suggestions waiting for you.

Choose the chip to add or remove tags right there, without opening the record. Choose
**+2 suggested** to accept or reject the suggestions. On a record without tags, point at the row to
see the tag icon (**Add tags**).

When a row is too narrow, its tags are hidden before its title is cut short.

On the **Features** list the chip names each tag, such as **billing · api**, and folds into
**3 tags** only when the row is short of room. See [Features](/user-guide/product/features).

### To add a tag from a list

1. Point at the record's row, and choose its tags chip, or the tag icon on a row without tags.
2. Type a tag and press Enter, or pick one of your workspace's tags.

The tag appears on the row, spelled the standard way.

### To remove a tag from a list

1. Choose the record's tags chip.
2. Choose the **x** on the tag.

The tag leaves the row. A tag Productmind suggested is remembered as rejected, so it isn't suggested
again for that record.

You can also edit a record's tags from its own page: choose **Tags** (the tag icon) in its header.

## Tagging features in a re-scan review

When you review a [re-scan](/user-guide/product/rescans), you can tag the proposed additions,
links, renames and moves before they're applied, one by one or several at once, with the same tag
editor and your workspace's feature tags. A tag on a change passes to the changes under it.

The tags land on your features when you choose **Apply**, on the feature of each change that is
accepted or amended. A feature that already has the tag, in any spelling, keeps it as it is, and a
tag someone removed or rejected on that feature is added back. Tags on declined or undecided
changes are dropped. See [Tagging changes](/user-guide/product/rescans#tagging-changes).

## Filtering a list by tag

Every list with tags has a **Tags** filter in **Filters**. Its options are the tags used on that
list, and a search box appears once there are more than eight.

Choose one or more tags to see the records that carry any of them. While the filter is set, it shows
in the search box, as **Tags: billing** or **Tags: 2**. Choose its **x** to clear it.

Tags spelled differently but saved the same way, such as **Billing** and **billing**, are one option,
named with the spelling most records use. Choosing it finds every spelling, so older records stay
easy to find.

## Suggested tags

Productmind can suggest tags for a record from what it says, using your workspace's existing tags
where they fit.

### To get tag suggestions

1. Open the tag editor: choose the record's tags chip on its list, or **Tags** in its header.
2. Choose **Suggest tags**.

When they're ready, the suggestions appear under **Suggested**. Accept each with its check mark, or
choose **Accept all**. Reject one with its **x**.

On the **Knowledge base** list you can select several documents and choose **Suggest tags** for all of
them at once.

Suggested tags are spelled the standard way too, and Productmind doesn't suggest a tag the record
already has, or one you rejected, in any spelling.

## Permissions

| To | You need |
| --- | --- |
| See tags | Read on the record, such as **Tasks: Read** |
| Add tags, accept suggestions and get suggestions | **Tags: Create** |
| Remove tags and reject suggestions | **Tags: Delete** |
| Edit tags from a list row | **Tags: Create**, and Update on the record, such as **Tasks: Update** |
| Tag or untag changes in a re-scan review | **Tags: Create** and **Features: Update** |

Without them, you still see a record's tags on its row: choose **3 tags** to read the whole list.

## Related topics

- [Features](/user-guide/product/features)
- [Tasks](/user-guide/tasks)
- [Knowledge base](/user-guide/knowledge-base)
- [Glossary](/user-guide/reference/glossary)
