What TAG Lens writes to Photos

TAG Lens edits metadata only. This page is the complete list of what it writes, where that ends up, and who can see it.

![writes-ledger]

The ledger

TAG Lens removes a keyword only when you tell it to, and ⌘Z puts every removal back. There are four ways you can: remove a tag chip from a photo; Remove a tag from a multi-photo selection (it confirms the count first, and the whole batch undoes as one ⌘Z); the Settings clean-up that strips a banned tag from the photos still carrying it (also one grouped ⌘Z); and Consolidate Tags, which replaces variant spellings with the one you keep after you review the plan. TAG Lens can also suggest a removal. It suggests one only for a keyword the AI added that doesn't match the photo's visual neighbours (e.g. a stray "cat" on a photo whose look-alikes are all coins). That is suggestion-only: you accept it one card at a time, and it never suggests removing a keyword you typed.

TAG Lens can also add inferred locations in bulk, only when you ask. When several photos have no GPS, the location suggestion offers Review all N location fixes: a list of each photo and the coordinate TAG Lens inferred from a geotagged photo taken nearby in time. Because an inferred location is a guess, nothing is pre-checked: you tick only the ones you trust, and the whole set writes (and undoes with a single ⌘Z) together.

TAG Lens can also repair a cluster of dates at once. When a scan or import collapses many photos onto a single timestamp, the date suggestion offers Review all N together, a preview of every photo's current date beside the date TAG Lens proposes (taken from a near-identical shot you already dated). Nothing is written until you press Apply, you can switch any photo off in the list, and the whole repair undoes with a single ⌘Z. When the frames you've dated by hand on a film roll agree on a year, TAG Lens can offer that year to the roll's scan-stamped frames too, always a suggestion you review.

When instead several photos have a caption or title that names a different year than their stored date, the date suggestion offers Review all N caption dates, each photo's current year beside the year you wrote. Because that year comes from your own words, the photos start pre-checked; switch any off, and Apply (with one ⌘Z to undo) writes them together.

Through macOS 26, Photos had no write API for star ratings, so TAG Lens keeps them in its own local database, keyed to each photo's library identifier. That local file is their home. macOS 27 added a ratings API, so there you can also send your stars into Photos' own rating field with Library ▸ Promote Stars to Photos…, after which they sync like any Photos edit; the command is hidden on earlier macOS, where the API doesn't exist. Stars (1–5) also embed as IPTC StarRating in any JPEG you drag, share, or export, where Lightroom, Bridge, and Photos can read them. Reject marks stay app-local. Settings ▸ Ratings Backup exports ratings, rejects, and your film rolls (the roll names, asserted camera/stock, and photo assignments) as one JSON file and merges them back in. Do this before migrating or rebuilding your Photos library, because a rebuild can change those identifiers.

Export Photo Info as CSV… (File menu, ⇧⌘E) writes a spreadsheet of the current selection, or the whole filtered view, to a file you choose: keywords, title, caption, date, rating, and the reject and favorite marks. The file includes each photo's precise latitude and longitude unless you say otherwise: the save panel shows an Include location (GPS coordinates) checkbox on every export, pre-set from the Strip location when sharing or exporting setting (Settings ▸ Tags & Privacy ▸ Sharing & export), so exact coordinates leave only on your explicit choice.

Export to Folder… (File menu) copies the selected photos into a folder you choose, alongside a metadata.csv of their keywords, title, caption, and rating. Pick the Format on the panel: Keep original files copies your originals byte-for-byte, RAW or HEIC or whatever they are (the default); Convert to JPEG saves viewable JPEG copies (re-encoded, so not your originals) with your keywords, title, caption, and star rating written inside each JPEG, the same fields a dragged copy carries, honoring the same location-strip setting, while any RAW negatives are copied untouched into a RAW Originals/ subfolder beside them. Either way your originals are read and left as they are, and nothing leaves your Mac beyond the folder you pick. Originals stored in iCloud download first, and a photo whose original can't be fetched is reported, with no lower-quality copy in its place.

Three promises

• TAG Lens never modifies pixels: it writes metadata fields only. Your originals are never edited, recompressed, or replaced. A Convert to JPEG export makes new JPEG copies in the folder you pick and leaves your originals in Photos untouched. TAG Lens never sends your photos anywhere on its own and uploads nothing by default. A copy leaves your Mac only when you drag, share, or export one, and that shared copy carries the keywords, title, caption, any star rating, and the location you've put on it, unless you strip the location in Settings ▸ Tags & Privacy ▸ Sharing & export. The one direct upload is Publish to Flickr… (File menu, only after you connect your own Flickr account in Settings ▸ Tags & Privacy ▸ Sharing): the photos you marked For Flickr upload to your account only when you run the command and confirm its sheet, and that sheet makes you choose who can see them and which license they carry, every batch, so your Flickr account's defaults decide nothing. Your named people's tags stay on your Mac, held by the same fence that keeps them out of every online lookup. Six optional lookups exist, all off until you turn them on, each behind its own consent in Settings ▸ Online Enrichment:
• Related-keyword enrichment sends only the tag term you typed.
• The Ask an AI tier sends only that term to the AI provider you choose: local Ollama, or a hosted provider you key, such as xAI, OpenAI, Anthropic, Mistral, Groq, or DeepSeek.
• Place-name resolution sends a photo's GPS coordinates to Apple's geocoder.
• Place-from-photo-text reads a place name off a sign in a No-Location photo and sends only that text to Apple's location search to suggest a coordinate.
• The landmark guess asks the AI model running on your own Mac to name the place a No-Location photo shows, then sends only that guessed name to Apple's location search to suggest a coordinate. It is labeled as a guess and written only when you press Use.
• Recognize famous photographs fetches one public catalog file listing famous works and their documented tags. No term and no pixels go with the request, and nothing in it is about you.

Installing the optional control photos (onboarding, or Settings ▸ Control photos) downloads that catalog's images from the public archives it lists, a download to your Mac; nothing about you or your library is sent. When you search for a place by name, in Set Location or when recording where a person or object lived, the words you type go to Apple's location search to find matching places, the same as typing in Maps: only that text is sent. (If you use iCloud Photos, Photos itself syncs metadata edits the same way it syncs any edit you make in Photos.)

• Nothing is deleted without a system confirmation: TAG Lens never deletes on its own. There are two ways you can delete your own photos: the cull, Delete Rejected Photos (⌘⌫), and the inspector's Delete… button on the current selection. Both take the same safe path, one macOS confirmation dialog, then the photos go to Photos' Recently Deleted album, where Photos keeps them recoverable for around 30 days. One more command, Settings ▸ Control photos ▸ Remove Control Photos…, removes only the optional control photos you chose to install, down that same confirmed, recoverable path.
• Every write is undoable: each change, including a story's memoir notes, records its reverse on the ⌘Z stack, up to the 50 most recent actions in the current session. A multi-photo batch undoes as one action. The stack is per-session: quitting the app clears it.

How the writes happen

Keywords, titles, and captions are written through Photos automation (the macOS Automation permission); favorites, capture dates, locations, albums, deletions, and the optional control-photo imports go through Apple's PhotoKit. Both paths write into the same Photos library you see in the Photos app. There is no separate TAG Lens copy of your library.

Related

• Back up your ratings
• Stories and the memoir
• Undo any change
• Cull with x

This page is generated from the same in-app help topic TAG Lens ships, and the engineering covenant behind it lives in the repo as ADR-0010 — the same-change rule means neither can drift from the code without failing the build.