By David · June 22, 2026 · Updated September 3, 2026 · 14 min read

Lightroom keywords tutorial: how to add, organize and sync keywords in Lightroom Classic

I spend a lot of time in Lightroom's metadata layer, partly because I build tools that sit on top of it. Face Tagger applies person-name keywords using face recognition. Smart Search lets you find photos by typing a description, then optionally writes those descriptive tags as keywords. Both tools revealed the same pattern: photographers with an organized keyword hierarchy find things instantly; photographers without one search by date and hope.

Keywords are not the most exciting part of Lightroom Classic. But they are the part that makes the catalog pay off at scale. This tutorial walks through the whole thing in the order you will actually meet it: adding keywords, building a hierarchy, keyword sets, the Painter tool, writing keywords into your files, tagging a whole shoot at once, and where the arithmetic breaks down badly enough that an AI plugin is the better answer.

What are keywords in Lightroom Classic, and where do they actually live?

A keyword in Lightroom Classic is a text tag stored in the catalog database. It is not a folder name, not a collection, and not part of the filename. When you tag a photo "coastal-maine", that string lives in the catalog alongside the photo's develop settings and other metadata.

Keywords can be written to the photo file on request via Metadata > Save Metadata to File (Cmd+S on Mac, Ctrl+S on Windows). For raw files this creates an XMP sidecar. For JPEGs and TIFFs it writes into the file itself. Either way, the keywords travel with the file if you move it to another catalog or application that reads XMP.

The distinction from collections is worth stating clearly. A collection is a curated grouping, assembled manually or automatically. A keyword is a property of the photo itself. You can use keywords as the basis for a Smart Collection, so all photos tagged "client-wedding" appear in a Smart Collection filtered on that keyword automatically. But the keyword exists independently of any collection.

Most photographers treat keywords as a search box and stop there. That is maybe a fifth of what they actually do:

• Filter bar in the Library grid. The obvious one. A "Keywords contains" filter narrows thousands of photos in seconds.
• Smart Collections. A Smart Collection with the rule "Keywords contains Sarah" re-populates itself every time you tag a photo with Sarah. The album builds itself as you tag.
• XMP and IPTC metadata on export. Keywords embed as dc:subject (XMP) and IPTC Subject. Stock agencies, asset managers, and other photo apps read those fields. If you license images, keyword metadata is how buyers find your work downstream.
• Publish Service filtering. Some Publish Services let you decide what to publish from keyword rules. Tag a set of client selects, publish exactly those in one operation.

How to add keywords in Lightroom Classic (step by step)

If you have never keyworded anything, here is the five-minute version. Everything else in this tutorial is a refinement of these five steps.

1. Select photos in the Library module. Press G for Grid view and select one photo or several (Shift-click a range, Cmd-click or Ctrl-click to add individual frames). Every keyword you add lands on the whole selection, which is the single biggest time-saver in this post.
2. Type in the Keywording panel. In the right panel, open Keywording, click the field labelled "Click here to add keywords", type your keywords separated by commas, and press Enter. Existing keywords autocomplete as you type, so you rarely type a full word twice.
3. Nest the keyword in the Keyword List. Open the Keyword List panel just below Keywording and drag the new keyword onto its parent: "Sarah" onto "Family", "Family" onto "People". From now on, tagging the child also tags every parent above it (more on why that matters below).
4. Write the keywords to the files. Choose Metadata > Save Metadata to File (Cmd+S / Ctrl+S), or turn on "Automatically write changes into XMP" in Catalog Settings so it happens on every change.
5. Keep the hierarchy on export. In the Export dialog, under Metadata, choose All Metadata and tick Write Keywords as Lightroom Hierarchy so the full keyword path travels inside the exported file.

The six places you can add a keyword

Lightroom Classic gives you six entry points, each suited to a different moment in the workflow:

1. Keywording panel (Library module, right panel). Select one or more photos, then type in the "Click here to add keywords" field. Separate multiple keywords with commas. This is the workhorse method for post-shoot tagging sessions.
2. Painter tool (Spray Can). In Grid view, click the Painter icon in the toolbar (press T to show the toolbar if it is hidden). Set the mode to Keywords, type your keyword, then click or drag over photos. Fast for applying one keyword to many scattered photos without selecting them first. It gets its own section below.
3. Import dialog. The Apply During Import panel on the right side includes a Keywords field. Good for tags that apply to the entire shoot: the shoot name, location, client name, or event. Those tags go on everything in the import automatically.
4. Batch select then type. Select all photos you want to tag (Cmd+A or Ctrl+A for all, or Shift-click a range), then type in the Keywording panel. The keyword lands on every selected photo at once. This is how I apply broad category keywords to a whole shoot in under a minute.
5. Drag onto the Keyword List. Select photos in Grid view and drag them onto any keyword in the Keyword List panel. No typing at all. Useful when you can already see the keyword you want and just need it on a selection.
6. Copy and paste metadata. Select a photo that is already tagged correctly and press Cmd+C (Ctrl+C on Windows), then select the target photos and press Cmd+Shift+V (Ctrl+Shift+V). The dialog lets you tick Keywords only, so you do not overwrite anything else by accident.

Two other panels are worth knowing about. Keyword Suggestions shows keywords you have used on recent similar photos. Keyword Sets lets you save a palette of nine frequently used keywords assignable by pressing number keys 1-9. For high-volume work, these cut typing time significantly, and both get their own section below.

Why do photographers skip keywording, and why does June 2026 change the math?

The honest answer is time. A 400-photo shoot with 50 unique subjects, locations, and moments requires hundreds of individual tagging decisions. Multiplied across a full year of shooting, that is days of catalog work that produces no new images and earns nothing. Photographers skip it because the payoff is deferred and the cost is immediate.

Two things change that calculus now.

First, Lightroom Classic 15.4 (released June 2026) added keyword sync to the cloud ecosystem for the first time. Keywords you apply in Lightroom Classic now propagate to Lightroom mobile and the web interface. An empty keyword list used to mean Classic could not find things. Now it means neither Classic nor mobile nor the web can find things. The blast radius is wider.

Second, AI tagging tools have gotten good enough to handle the repetitive parts. Face recognition can apply person-name keywords across thousands of photos without manual click-per-face work. Content-based search can identify photos by scene description without requiring pre-applied tags at all. The keyword problem has not disappeared; the tools that handle it have improved dramatically.

How to build a keyword hierarchy that holds up at scale

The Keyword List panel in Lightroom Classic supports a full tree structure: parent keywords with nested children, any depth. The temptation is to build a taxonomy that would satisfy a professional librarian. The reality is that deep hierarchies become confusing and hard to maintain over time.

A flat top level with four to six categories holds up better in practice:

Three ways to nest a keyword

• Drag it. In the Keyword List, drag any keyword onto another and it becomes that keyword's child. Drag a whole branch and the children come along.
• Create it inside a parent. Select the parent in the Keyword List, click the + at the top of the panel, and in the Create Keyword Tag dialog tick "Put inside" the selected keyword. The same dialog has the Synonyms field and the three export checkboxes we will get to below.
• Import the whole tree from a text file. Metadata > Import Keywords accepts a plain text file with one keyword per line, where tab-indented lines become children of the line above. Build your full hierarchy in a text editor once, import it, and you are done. No typing each entry individually into the panel.

The test I apply before adding any keyword: "Would I realistically search for this?" If the answer is no, the keyword is noise. Keywords you never filter on slow the Keyword List and clutter the autocomplete suggestions when you start typing.

One structural rule worth following: keep People keywords specific and nested under a People parent rather than at the top level. This lets you filter on the parent to see all people-tagged photos at once, which is useful for checking coverage before delivering to clients.

Three further rules keep a schema durable over the years:

• Stop at three levels. People > Family > Sarah is deep enough. Beyond that the paths take too long to navigate and you stop applying them.
• Use singular nouns. "Heron", not "Herons". Lightroom does not normalize plurals, and an inconsistent library ends up with both.
• Do not duplicate meaning across branches. "Street photography" under Subject and "Urban" under Location will make every tagging decision ambiguous. Pick one home for the idea and keep it there.

What Lightroom does silently with your hierarchy

When you assign a keyword, Lightroom also assigns every parent above it. This is parent-keyword propagation, and it is the feature most photographers have never noticed.

If your hierarchy is People > Family > Sarah and you tag a photo "Sarah", the photo is also tagged "Family" and "People". A filter or a Smart Collection on "People" includes it, even though you only ever typed one name. You can keep a collection for your whole people library, one for family, and one for a single person, all fed by a single tag applied once.

The propagation only fires if the hierarchy exists. A root-level "Sarah" with no parent has nothing to propagate through: the collections do not group her, and the exported metadata carries no structure. The hierarchy is the infrastructure; everything else runs on top of it.

Keyword sets: nine keywords on the number keys

A keyword set is a palette of up to nine keywords loaded into the bottom of the Keywording panel. Lightroom ships three (Outdoor Photography, Portrait Photography, Wedding Photography) plus a rolling Recent Keywords set, and you switch between them from the Keyword Set dropdown in the panel.

The point of a set is speed. Hold Option on Mac (Alt on Windows) and each keyword in the set shows a number; press Option+1 through Option+9 (Alt+1 to Alt+9) to toggle that keyword on the selected photos without touching the mouse. Option+0 (Alt+0) cycles to the next set. On a wedding, a set of Ceremony, Reception, Portraits, Details, Family, Bride, Groom, Guests and Venue means the whole first pass through the grid is arrow key, number, arrow key, number.

To make your own, open the Keyword Set dropdown and choose Edit Set (also under Metadata > Keyword Set). Fill the nine slots, then Save Current Settings as New Preset and give it a name like the shoot type. A set is a shortcut, not a category: the keywords still live in your normal Keyword List, so build the hierarchy first and put leaf keywords in the set.

The Painter tool: spray one keyword across a whole grid

The Painter (the spray-can icon in the Grid view toolbar; press T if the toolbar is hidden) is for the opposite situation to keyword sets: one keyword, many scattered photos. Instead of selecting and typing, you click.

1. Click the spray can, or choose Metadata > Enable Painting. The cursor becomes a can.
2. In the toolbar, set the Paint dropdown to Keywords and type the keyword (or several, comma-separated) in the field that appears.
3. Click any thumbnail to apply the keyword, or click and drag across a run of thumbnails to hit them all.
4. Made a mistake? Hold Option (Alt) and the can turns into an eraser: click a photo to remove that keyword again.
5. With the Painter set to Keywords, hold Shift to pop up your current keyword set and pick from it without retyping.
6. Click the round slot in the toolbar (or press Esc) to put the can away when you are done, otherwise the next stray click tags something.

The Painter also sprays star ratings, flags, color labels, develop presets, and metadata presets, which is why it is worth learning once: the same click-to-apply motion covers most of the first-pass sorting you do on a fresh import.

Sync keywords to metadata and write the keyword hierarchy to files

Everything so far lives inside the catalog. That is fine until the catalog is lost, you switch computers, or you send a file to someone who does not have your catalog. Two settings and two checkboxes control whether keywords leave the catalog and how much of the tree goes with them.

Writing keywords to the file

Metadata > Save Metadata to File (Cmd+S on Mac, Ctrl+S on Windows) writes the selected photos' keywords, ratings, labels and develop settings to disk: an XMP sidecar next to a raw file, or into the file itself for JPEG, TIFF, PSD and DNG. If you would rather never think about it, open Catalog Settings, go to the Metadata tab, and tick Automatically write changes into XMP. From then on every keyword you add is written within a few seconds. The cost is a little disk chatter on big batches; the benefit is that a dead catalog no longer takes your tagging with it. I cover the trade-offs in more depth in the guide to Lightroom Classic XMP sidecar files.

A small arrow badge on a thumbnail means the file and the catalog disagree. Metadata > Read Metadata from File pulls the file's version back in; Save pushes the catalog's version out. Pick a direction before clicking, because both overwrite.

Write Keywords as Lightroom Hierarchy

A flat keyword list survives everywhere: it goes into the file as XMP dc:subject and IPTC Subject, the fields nearly every photo app reads. The tree is another matter. Lightroom stores the full path (People|Family|Sarah) in its own XMP field, lr:hierarchicalSubject, and in the Export dialog there is a checkbox in the Metadata section called Write Keywords as Lightroom Hierarchy that decides whether exported files get it. Leave it ticked and another Lightroom catalog that imports the file rebuilds the same tree. Untick it and the receiving catalog dumps every keyword at the root level, which is how a colleague ends up with 400 orphaned keywords and a bad opinion of your organization.

The three checkboxes on every keyword

Right-click any keyword and choose Edit Keyword Tag. Below the Synonyms field are three checkboxes that control what happens on export:

• Include on Export. On by default. Untick it for organizational parents that mean nothing outside your catalog ("Status", "Workflow") and the parent stays internal while the leaf keywords still travel with the file.
• Export Containing Keywords. Whether tagging "Sarah" also writes "Family" and "People" into the exported file. Keep it on unless the parents are private.
• Export Synonyms. Whether synonyms you added (Grandma for "Sarah", say) are written out as extra keywords. Useful for stock, noise for a family archive.

Bulk keywording: tag a whole shoot in minutes

The mistake that makes keywording feel endless is tagging one photo at a time. Almost every shoot can be tagged in three passes, from broad to narrow, and none of the passes involve clicking individual photos until the last one.

1. Tag the whole import at once. In the Import dialog, type the shoot-wide keywords (client, location, event, year) into Apply During Import > Keywords. Every photo arrives already tagged with the things that are true of all of them.
2. Tag by selection. Back in the Grid, Cmd+A (Ctrl+A) for everything or Shift-click a run of frames, then type the keywords that apply to that chunk (Ceremony, Reception, the venue) into the Keywording panel. A 1,000-photo wedding usually breaks into eight or ten such chunks.
3. Sync from one done photo. Tag one photo perfectly, select it plus its siblings, and click Sync Metadata at the bottom of the right panel (or use Copy Metadata / Paste Metadata, Cmd+Shift+C and Cmd+Shift+V). Tick only Keywords in the dialog and every selected photo inherits the set.
4. Finish with the Painter and keyword sets. The scattered one-offs (the dog, the ring shot, the one guest who matters) are what the spray can and Option+number keys are for.

The one thing to watch when syncing is that Sync Metadata and Paste Metadata replace the keyword field on the targets by default if you leave the other metadata boxes ticked. Tick only Keywords and the existing tags on the target photos are kept and the new ones added.

Let Smart Collections do the filing for you

The payoff for a clean hierarchy is a set of collections that organize the library without any manual sorting. Build these once and then forget about them:

• Family portraits. Rule: Keywords contains "Family". Every photo of a family member appears automatically, whatever folder it lives in.
• Wildlife portfolio. Rules: Keywords contains "Wildlife" AND Star Rating is greater than or equal to 3. Continuously curated as you tag and rate.
• Client work. Rule: Keywords contains "Clients". Every client shoot in one place, across years and folder structures.
• Untagged photos. Rule: Keywords are empty. A running list of the backlog, so it stays visible instead of quietly growing.

Because parents propagate, you never add anything to these by hand. Tag "Sarah" and she lands in the family collection. Tag "Heron" and it lands in the wildlife one. The tagging is the filing.

Let the plugin do the tagging: people and content keywords

Manual keywording breaks down in two specific ways. The first is people: recognizing a face and applying the correct name requires looking at every face in every photo. At 30,000 photos this stops being a workflow problem and becomes a combinatorics problem. The second is content: describing what is in a photo ("sunset over water", "child laughing", "empty chair by window") requires language that varies per image and is impossible to standardize into a fixed keyword palette.

These two problems call for different tools, and I built one for each.

Face recognition for person keywords. Face Tagger runs a local ArcFace model against your library, clusters faces by identity, and lets you name the clusters. Once you name a person, it applies that person's keyword to every photo containing their face across the entire catalog, retroactively. A library with 5,000 photos of the same 12 people can be fully name-tagged in an afternoon rather than weeks of manual work.

Content-based search for scene keywords. Smart Search takes a different approach. It builds a semantic index of your photos using CLIP embeddings, then lets you search by typing what you are looking for: "sunset at the beach", "people laughing around a table", "foggy city street". It finds photos matching the description even if no keyword was ever applied. You can optionally write matching results as keywords, layering the Smart Search index directly on top of your keyword structure.

This is where the hierarchy you built earlier decides what auto-tagging is actually worth. Face Tagger writes a person's name into your People branch, so a recognized face immediately shows up in the family Smart Collection you already made. Smart Search deposits scene keywords into your Subject branch, so those collections stay current too. If the keyword list is flat, both tools still write the tag, but there is no structure to propagate through: you end up with a pile of auto-generated keywords sitting at the root level, disconnected from everything else. Design the tree before you bring AI into the workflow, even if you plan to tag by hand for a while. The AI fills in the structure you gave it.

A third category worth knowing exists: microstock keywording tools like LrTag or Wordroom generate keyword suggestions optimized for stock marketplace vocabularies. These serve a different goal, maximum discoverability on a stock platform, and produce different output (40-50 generic keywords per photo rather than 5-15 specific ones). If you sell on microstock, the vocabulary and density requirements differ from personal library management, and a dedicated tool for that market makes more sense than a general tagging workflow.

Frequently asked questions about Lightroom Classic keywords

Do Lightroom Classic keywords write to the file or just the catalog?

By default, keywords live only in the catalog. To write them to the file, use Metadata > Save Metadata to File (Cmd+S on Mac, Ctrl+S on Windows). For raw files this creates an XMP sidecar. For JPEGs and TIFFs it writes into the file itself. Catalog Settings has an option to write metadata automatically on every change, which keeps files and catalog in sync without manual saves.

How many keywords should a photo have?

For a personal or editorial library, 5-15 specific keywords is a reasonable range. More than that and the value of individual keywords decreases; fewer and you may not have enough signal to filter effectively. Microstock workflows use 40-50 per photo because platforms weight keyword count in search rankings, but that logic does not apply to a personal catalog where you control what gets surfaced.

Do keywords from Lightroom Classic show up in Google Photos after you publish?

No. The Google Photos API does not accept keyword or tag metadata on upload, and Google Photos does not read XMP data from the image file. Your keywords stay in the Lightroom catalog and any XMP sidecars. They do not appear in the Google Photos interface after publishing, regardless of which publish plugin you use.

What is the difference between keywords and Smart Collections?

Keywords are metadata properties stored with the photo and portable via XMP. Smart Collections are saved filter queries that automatically include photos matching rules you define, including keyword rules. A Smart Collection filtered on the keyword "coastal-maine" is a live view that updates automatically whenever you apply or remove that keyword. The keyword is the data; the Smart Collection is a window onto it.

Can I import a keyword list from a text file into Lightroom Classic?

Yes. Go to Metadata > Import Keywords in the Library module. Lightroom Classic accepts a plain text file with one keyword per line. Tab-indented lines become children of the parent keyword above them. Build your hierarchy once in a text editor, import it, and every keyword is ready to apply without typing each entry into the panel one by one.

How many keywords is too many in the Keyword List?

There is no hard limit, but a flat list of more than 200-300 root-level keywords gets unwieldy fast. A three-level hierarchy scales to tens of thousands of photos because you only ever apply the leaf level and the parents aggregate automatically. The number of leaf keywords barely matters as long as the structure is consistent and the parents stay tidy.

Should I use keywords or color labels to organize photos?

Both, for different jobs. Color labels are for temporary workflow state: red for rejects to review, yellow for edits in progress, green for client selects. Keywords are for permanent, searchable attributes - people, subjects, locations, projects - that you want to find months or years later. Mixing the two is what makes a library confusing when you come back to it after a long gap.

What are keyword sets and when should I use them?

A keyword set is a group of up to nine keywords loaded into the Keywording panel and applied with a click or the number keys 1-9. They shine on shoots with predictable tagging needs: a wildlife trip set with your common species, or a wedding set with Ceremony, Reception, Portraits, Details, Family. You switch sets from the dropdown at the top of the Keywording panel.

How do I export keywords so they show up in other apps?

In the Export dialog, set Include to All Metadata. Keywords then embed as IPTC Subject and XMP dc:subject, the two fields most photo apps, DAMs, and stock platforms read. For DNG exports the full hierarchy travels with the file. The one exception: a parent keyword with "Include on Export" unticked stays behind. Leaf keywords always export.

Do Lightroom Classic keywords sync to Lightroom mobile?

For photos in synced collections, yes. Since Lightroom Classic 15.4 (June 2026), keywords propagate along with the collection to Lightroom mobile and the web. Photos that live only in Classic folders and were never added to a synced collection stay local, keywords included. If you want a tagged photo findable on your phone, put it in a collection with syncing turned on.

What does Write Keywords as Lightroom Hierarchy do?

It is a checkbox in the Metadata section of the Export dialog. With it on, exported files carry the full keyword path (People > Family > Sarah) in the XMP lr:hierarchicalSubject field alongside the flat dc:subject list, so another Lightroom catalog that imports the file rebuilds the same tree instead of dumping every keyword at the root level. Leave it on unless the file is going somewhere that only reads flat IPTC keywords.

Does this Lightroom keywords tutorial apply to Lightroom 5 and 6?

Yes. The Keywording panel, the Keyword List, keyword sets, the Painter tool, Save Metadata to File and Write Keywords as Lightroom Hierarchy all exist in Lightroom 5 and Lightroom 6 and work the same way. The only things missing in the old versions are the June 2026 cloud sync of keywords and support for current plugins.