# Tags

Source: https://frameleaf.app/docs/using/tags/

Tags let you label photos and videos your own way, then find them again in a click. Put tags inside other tags to build a tree that suits your library, such as `Hobbies/Hiking` or `Family/Holidays/Christmas`.

Your tags travel with you. Frameleaf reads tags you've already added in other apps, from the XMP `TagsList` and `HierarchicalSubject` fields and IPTC `Keywords`, and writes your changes back to a sidecar file next to the photo, so other apps see them too.

## Where to find it

**Tags** is under Explore in the sidebar. Tags are on for every account. To hide them, open **Settings**, then **Your preferences**, then **Tools & sidebar**, and in the **Tags** row turn off **Use**, or turn off only **Show in sidebar** to keep tags and drop the sidebar link.

## Tag photos

To tag one photo:

1. Open the photo and show **Info**.
2. Choose **Add a tag**.
3. Pick one of the **Tag suggestions**, or type a new name to create the tag.

To tag many at once:

1. Select the photos in the Library, an album or search results.
2. In the selection bar, open **More** and choose **Tag**. Right-clicking the selection offers **Tag** too.
3. Type to search your tags, or choose **Create tag** for a new one. The tags you pick are listed under **Chosen tags**.
4. Confirm with the button that says how many items will be tagged.

Tagging a selection can be undone from the selection bar; the tag comes off only the photos that didn't already have it. To take a tag off one photo, open its **Info** and remove the tag there.

## The Tags page

The Tags page lists every tag with how many items it holds.

[![The Tags page in Cards view: each tag as a card with four photos, its colour dot, item count and the tags inside it, with Find a tag, a sort menu, Cards and List buttons and New tag at the top.](https://frameleaf.app/shots/docs/tags-2026-11.jpg)](https://frameleaf.app/shots/docs/tags-2026-11.jpg)

- **Find a tag** filters the list as you type.
- **Sort tags** orders them by **Most used**, **A–Z** or **Newest photos**.
- **View** switches between **Cards** and **List**. The list shows each tag's **Items**, **Tags inside** and **Newest item**, and **Expand all** opens the whole tree.
- **New tag** makes a tag. Give it a **Name**, choose which tag it goes **Inside**, or **None (top level)**, and pick a **Colour**.

Open a tag to see its photos. **Include tags inside** is on to begin with, so a tag shows its own photos and those of every tag inside it. Turn it off to see only what carries that tag itself.

### Rename, colour, move, merge and delete

On a tag's page, or from the menu beside a tag in the list:

| Action | What it does |
| --- | --- |
| **Rename** | Changes the name. A name can't contain a slash, and two tags in the same place can't share a name. |
| **Colour** | Gives the tag one of eight colours, so it stands out in lists and on photos |
| **New tag inside** | Makes a tag under this one |
| **Move** | Puts the tag, and everything inside it, under another tag or at the top level |
| **Merge** | Everything with this tag gets the tag you choose instead, and this tag is removed. Tags inside it move across too. Merging can't be undone. |
| **Delete tag** | Removes the tag and the tags inside it. The photos lose the tag and stay in your library. |

**Tag photos** on a tag's page reminds you how to add to it: select photos, choose **Tag** in the selection bar and pick the tag.

## Search by tag

- Type `tag:` and the tag's name in the search box: `tag:water`. Put **-** in front to leave a tag out: `-tag:screenshot`. Two `tag:` filters find photos with both tags. See [Search syntax](https://frameleaf.app/docs/using/search-syntax/#tag).
- In the filter panel, the **Tags** section picks one or more tags.
- Under **Library status**, **Untagged** finds photos with no tags, and **Has tags** can be set to **Yes** or **No**.

## Tags from an existing library

If your photos already had tags when they were added, Frameleaf reads them in with the rest of each photo's details. To read them again for photos that were added before, an administrator can open **Settings**, then **Computers & background work**, then **Background work**, and choose **Do it all again** on **Reading photo details**.

## Suggested tags

Frameleaf tags photos for you with what smart search sees in them, such as `beach`, `forest`, `dog` or `cake`. It compares each photo with a built-in list of about 300 everyday labels covering scenes, animals, plants, food, activities, transport, objects, sports and events, and adds the closest matches.

Suggested tags are kept inside an **auto** tag, as `auto/beach`, `auto/dog` and so on. That keeps them apart from your own tags: browse them together, filter them out, or delete the **auto** tag to clear them all. Your own tags always stay exactly as you made them.

Suggested tags are added when a photo is read for smart search.

## Tags from AI descriptions

When [AI descriptions](https://frameleaf.app/docs/using/ai-descriptions/) are on, Frameleaf also adds tags for what it sees in each photo. They're ordinary, searchable tags, always lowercase, without duplicates and without filler words. They also decide which [built-in smart albums](https://frameleaf.app/docs/using/smart-albums/) a photo goes into.

## For administrators

Suggested tags are set in **Settings**, then **Search & intelligence**, then **Descriptions & tags**, in the **Tags** section:

| Setting | What it does | Default |
| --- | --- | --- |
| **Suggest tags automatically** | Suggests tags from what is in each photo. Tags people added are always kept. | On |
| **How many tags** | **Fewer, surer** (up to 3 tags on a photo, only the obvious ones), **Balanced** (up to 6, with an occasional wrong one) or **More tags** (up to 12) | Balanced |

**Advanced: suggested tags, in numbers** holds the two numbers behind **How many tags**:

| Setting | What it does | Default |
| --- | --- | --- |
| **Tag match strictness** | From 0 to 1. Higher gives fewer, surer tags. | 0.25 |
| **Most tags on one photo** | From 1 to 20. Tags people added don't count. | 6 |

Suggested tags come from visual search, so keep **Visual search** turned on. To add them to photos that were read before, choose **Do it all again** on **Preparing photos for search** in **Settings**, then **Computers & background work**, then **Background work**.

:::caution[Tags are visible when you share]
Anyone you share a photo with can see its tags, including partners, album members and shared links that show metadata. To keep something private, use [sharing permissions](https://frameleaf.app/docs/using/sharing/) and [Locked](https://frameleaf.app/docs/using/private-content/).
:::
