# Tags

> Add, edit, bulk-apply, and clean up the colored labels that organize your library.

Tags are colored labels on bookmarks. They come from two sources: you, and [AI auto-tagging](/docs/ai-tagging).

## Editing tags on a bookmark

On a card, up to 2 tag chips show, plus **+N** for the rest. Edit them inline via the card's **"..."** menu > **Edit tags**, or in the bookmark detail view. The tag editor lets you add existing tags or create new ones on the spot.

## Managing all your tags

Manage every tag in **Settings > Tags & Organisation** (the label is spelled "Organisation" in the app). There you can:

- Search your tags with the search box.
- Press **Add tag** to create one: pick a color and name (up to 50 characters, duplicate names are blocked).
- Click a tag's name to rename it inline.
- Change its color from the color dropdown.
- Delete a tag.

Edits apply across every bookmark immediately.

## Bulk tagging

<Steps>
  <Step title="Enter selection mode">
    Press **Select** on the bookmarks page.
  </Step>
  <Step title="Pick cards">
    Click the cards you want to tag.
  </Step>
  <Step title="Open the Tags menu">
    Press **Tags** in the floating action bar. The menu is tri-state per tag: checked (on all selected), a dash (on some), or empty (none). Click to add to all or remove from all. You can create a new tag inline here too.
  </Step>
</Steps>

## Cleaning up duplicates

Open **Settings > Tags & Organisation > Clean up tags**. It scans your tags and suggests merges, including AI-suggested groups of synonyms, plurals, and misspellings. Each group is labeled either "Suggested by AI" with a reason, or "Same name, written differently" for exact duplicates.

Each group is a ballot: check whether to merge it, pick which tag name survives (or rename it with the pencil), then press the **Merge groups** button, which shows how many groups are checked. Nothing merges until you confirm.

<Callout type="note">
Only high-confidence AI suggestions are shown. If AI is unavailable, the tool falls back to exact matches only.
</Callout>

## Filtering and searching by tag

Tag chips are filterable (see [Filters](/docs/filters)) and searchable, since tag names are one of [search](/docs/search)'s signals.

<CardGroup>
  <LinkCard slug="ai-tagging" title="AI auto-tagging" description="Let Stashr tag new saves for you." icon="🤖" />
  <LinkCard slug="filters" title="Filters" description="Narrow your library by tag." icon="🧮" />
</CardGroup>
