# Tags, collections and batch actions

Everything you write about an item lives next to it, in a text file. This page is about writing it faster: one item from the inspector, a hundred at once from the selection panel.

*Written from Teserra 1.3.16.*

**In short**

1. Select the items: `⌘`-click, `⇧`-click or `⌘A`.
2. Press `T` and type a tag, or pick a collection in **Add to collection…**
3. Changed your mind? `⌘Z` takes back exactly what changed.

## One item

![The right panel for one image, Cloud Path Landscape: the picture, the Constellation button, the title, a description of the misty mountain landscape, then Properties with the rating, dimensions, type, file and dates, and the Source link.](https://teserra.app/assets/docs/inspector.webp)

- The picture, and **Constellation** to see what belongs with it.
- The **title** and the **description**, edited in place.
- **Properties**: the rating, then dimensions, type, file and dates. A photo adds its camera details.
- The **source** it came from, then its **tags** and **collections**.

Title, description, rating, tags and collections are edited in place, and `0` to `5` rate the selection from the keyboard. Right-click an item for **Collections**, **Find Similar**, **Constellation**, **Copy Image**, **Share via AirDrop** or **Reveal in Finder**.

*(new in 1.3.18)* **Collections**, in that menu, is a checklist: a tick for each collection the whole selection is in, a dash and “1 of 2” when only part of it is. One click adds the selection or takes it out, and the menu stays open for the next one. Inside an open collection, the same menu also offers **Remove from** followed by the collection’s name, to take the selection out directly.

[Clip: Two pictures selected in Design. Right-click, Collections: Design is ticked, Dark Futurism shows a dash and 1 of 2. One click on Dark Futurism ticks it, and the menu stays open.](https://teserra.app/assets/snips/collections-menu.mp4)

[Clip: Inside Architecture, a picture is selected. Right-click, Remove from Architecture: it leaves the collection, then ⌘Z brings it back.](https://teserra.app/assets/snips/collections-remove.mp4)

## Collections

Collections nest, take an icon and a color, and one item can live in several. Drag items onto a collection in the sidebar to file them, or drop files from the Finder straight onto a collection to import them there. Deleting a collection never deletes its items.

## Several items at once

Select more than one item and the right panel turns into a place to act on all of them.

[Clip: In the Design grid five dark dashboard screenshots are selected one by one, the panel reads 5 images selected, and the tag dark ui is typed and added next to dashboard.](https://teserra.app/assets/snips/batch-tag.mp4)

From the top:

![The selection panel for three images of the Design collection: Export, Sheet and trash; What they share reads purple, bright, product shot, violet, gradient, with a palette and the Constellation button; Rating; Tags with 12 on some and the Add a tag to 3 images field; Collections; Colors.](https://teserra.app/assets/docs/selection-panel.webp)

- **Export…** (`⌘E`), **Sheet…** and the trash, for the whole selection.
- *(new in 1.3.13)* **What they share**: the style words and palette the images have in common, and **Constellation** ([what it draws](https://teserra.app/docs/search#constellation)).
- **Rating**: “all rated 4” when they agree, “mixed” when they do not. One click rates every item.
- **Tags**: the ones every item carries. “2 on some” unfolds the others, each with its count, “16/31”. **×** removes a tag from every item that has it; the field adds one to all.
- **Collections**: same chips. **Add to collection…** files the selection; its first choice, **New collection from these 31…**, creates one.
- **Colors**: the dominant colors. Click one to filter the library on it.

When some selected items have no tags, a line says “8 of 12 have no tags” with **Catalog them**: the Curator runs on those only.

**Needs:** A Curator key for **Catalog them** ([The Curator](https://teserra.app/docs/curator)). Without one, your agent can catalog them on your own AI plan ([Agent access](https://teserra.app/docs/agents)).

> **Undo, exactly.** Every batch action is one transaction, and `⌘Z` takes back only what changed: a tag added to 31 items comes off the 19 that did not have it, each rating goes back to its own previous value, a new collection disappears with its contents kept.

## Contact sheet

**Sheet…** writes one PNG, 2400 pixels wide, with every selected item laid out in rows in the order of the grid, on a light background. Teserra reads the originals, so the board is sharp enough to send to a client or drop in a deck. Choose where to save it; the Finder shows it when it is done. Agents can ask for the same thing over MCP. [Agent access](https://teserra.app/docs/agents)