Adding Keywords to Images

Capture One Pro provides a simple way to apply keywords to images to help both users and clients categorize, search and find photos.


Adding keywords is particularly useful in large catalogs but this option is no less important for multiple small catalogs and sessions as well. Keywords may also be important if you’re supplying photo agencies with images, where identification of the subject may be a requirement of submission.

Capture One supports hierarchal keywording and lists that are necessary for efficient organization. Hierarchical keywording makes it easier to find keywords and store them when hierarchies are collapsed. It is also a genuine time saver. Assigning the lowest level child keyword to an image adds all the keywords in the hierarchy.

Keyword data is stored by Capture One in XMP sidecar files by default for RAW and embedded in JPEG and TIFF files when assigned. Keywords applied to RAW files are only embedded when processed files (i.e., variants) are exported. Keyword data will not be embedded when exporting unprocessed RAW files (i.e., originals). Keywords are managed with two tools in the Metadata tool tab:

  • Keywords tool
  • Keyword Library tool

The Keywords tool interfaces with the selected image(s). Keywords can be added and removed from images using this tool.

The standard Capture One tool tips for local reset, local copy apply, pre-sets and help are available for this tool. See the section on Optimizing Your Workflow for more information.

The Keyword Library tool is used for managing the list (or lists) of keywords in the document. A document can be either a catalog or session. As the Keywords tool adds keywords to images, the document Keyword Library is populated. This forms a keyword list for any and all terms in the current document and is unique for the session or catalog.

Create and apply keywords to images

  1. Go to the Keywords tool found by default under the Metadata Tool Tab.
  2. Next select the image or images from the browser that you want to add the keyword tags to. Note, keywords cannot be generated in the Keyword tool unless images are selected first.
  3. Type the chosen keyword in the field labeled Enter Keywords…  in the Keywords tool. 
  4. Press enter/return key to add the keyword(s).
  5. To add another keyword tag or set of keywords, repeat from step 3.

Pro tip: Adding multiple keywords to an image or images using Keywords tool

  • Multiple keywords can be added by separating entries with a comma (,) and then pressing enter/return: e.g Denmark,Vikings,Beer…

Pro tip: Adding keywords to multiple images

To add keywords to multiple images either:

  • Select all the images required for the keywords (making sure Edit Selected Variants from the main toolbar is selected). Then type the keyword/s using the Keywords tool and press the enter/return key to add them.


  • Add keywords to one image then, while still highlighted, select the other images in batch and use the local copy and apply tool to paste the keywords to the others in the selection.

Pro tip: Working with keywords across multiple images

  • If a selection of images contains keywords and a particular keyword only applies to some of the selection, then a minus sign (-) will appear on the left side of the keyword. Clicking on a keyword with a minus sign (-) will add the keyword to all selected images.
  • Capture One has an auto-fill function for all Metadata fields including Keywords. As you start to type, Capture One will suggest keywords from those already added in your list. Click on one to select it, or scroll and click to select from a list, or use the up/down keys, then press enter. Note that the autofill function is not case sensitive.

Removing keywords from images

When a keyword is only applied to some images in a Variant group or a selection of images, a minus sign (-) will appear on the left side of the keyword in the Keywords tool. Pressing (X) will remove the keyword from only those images with that keyword within the selection. 

  1. Go the Metadata Tool Tab, and select the Keywords tool.
  2. Select the image(s) to remove the keywords from.
  3. In the Keyword tool mouse over the keyword and press the (X) icon that appears on the right side.
  4. Repeat to remove additional keywords.

Pro tip: To quickly remove all keywords from an image or variants that have been added from within Capture One only, select the images and use the local reset function, located on the Keyword tool's title bar.

When keywords originate from within XMP sidecar files, they can only be removed from an image or variant by pressing (X) on each keyword individually. This state is temporary with XMP. The keywords can be reapplied using the Keyword tool’s local reset function.

Enter hierarchical keywords

  1. Go the Metadata Tool Tab.
  2. Select the images that you want to add the keywords to.
  3. Select the Keywords tool and enter hierarchical keywords in the Enter Keywords… field, dividing the keywords using pipe (|) or greater than (>) as separators. For example; Denmark|Viking|Thor… or Denmark>Viking>Thor…
  4. Hierarchies can also be added in ascending order using the less than (<) symbol as the separator; Denmark<Viking<Thor... Note neither the space key or hyphen act as a separator.
  5. Press enter (Windows)/return (Mac) to assign the hierarchical keywords.

To amend an existing hierarchical set of keywords, click on the keyword displayed in the Keywords tool and drag it to the new relevant position in the hierarchy.

Note: Keyword tags entered into the Keyword tool may be saved as a User Preset. This is a quick and easy way to add extensive keyword lists to a series of images, even when importing images into a document (Session or Catalog). Presets can be selected from the Styles drop-down menu in the Adjustments tool on the import images dialog box. There are no limits to the number of presets that can be saved, and the presets can be stacked allowing multiple lists to be applied.

Pro tip: It is worth spending some time planning and organizing hierarchies. If you have an extensive list of keywords, it may be quicker and more efficient creating hierarchies in the Library tool and then dragging the existing keywords into them.

Removing hierarchical keywords

Hierarchical keywords can be removed from an image by pressing the (X) icon in the keyword in the same way as single keywords. If a parent keyword is removed in a hierarchical keyword, then the sub-keyword or child is also removed, as it is deemed linked to the parent.

More about hierarchical keywords

Hierarchical keywords are displayed in the Keywords tool UI as a flat list but retain their hierarchical relationship in the Keyword Library. To see the relationship, mouse over the keyword in the Keywords tool to get tool tip showing the full path.

If the same keyword exists in more than one Keyword Library then the keyword label is appended with its child relationship to help distinguish in the UI which list it belongs to. See managing lists for more information on making additional Keyword Library.

Rearranging keywords

Capture One has a unique feature that allows the user to rearrange the keywords in the Keywords tool. Note this feature is only available to single image selections. If a batch is selected (along with the Edit Selected Variants option), then the keywords are presented alphabetically and cannot be manually sorted. As a reminder of this, an icon is displayed to the right of the Enter Keywords field.

  1. To rearrange the keywords, click and drag the keywords to their new desired position.  This will form the order of keywords when exported or synced to XMP.

Advanced technical note with regard to rearranging hierarchical keywords

Hierarchical keywords can be rearranged in the Keywords tool. Note for the purposes of syncing to XMP or exporting, the Keywords tool will extract and populate the keyword IPTC field as a “flat list” in the order chosen.

If hierarchical keywords are used this in workflow their order will be preserved and represented in an additional XMP “bag”: the lightroom:hierarchicalSubject bag. There will, therefore, be some discrepancies in the order of keywords in this workflow between the two fields if viewing the variant in Lightroom, Bridge or an application that supports this XMP bag.

Keyword library

Every document (session or catalog) in Capture One has a Keyword Library. You can make additional shared Keyword Libraries which will load alongside every document Keyword Library. For more information, see the Creating a Keyword Library section below.

The default keyword library

Every document in Capture One has either a Session Keywords or Catalog Keywords library, depending on your chosen document type. As you add keywords to images in a catalog or session, the default keyword library for the document will automatically populate.

The Keyword Library displays two types of keyword:

  • Active (highlighted as solid gray) which indicates the word is applied to the image.
  • Passive (displayed black with a gray outline) indicating the word is in the library but not applied to the selected image. Passive keywords will remain in the library even if removed from all the images.

To remove a keyword from the document library (and any images that it is applied to), right click on the keyword and choose Delete Selected Keywords…

Creating a new keyword library

It is sometimes necessary to have a number of libraries, either for a specific purpose, or for controlling vocabulary. Libraries made in addition to the document library are referred to as “Shared”, as once created, any subsequent document opened or created will load these libraries alongside the default document library.

Shared libraries are stored in the application support folder with the extension .cokeywordsDB (see managing Keyword Library).

To create a new shared Keyword Library, click on the contextual menu (…) icon in the Keyword Library tool and choose from the following:

  • New (empty library).
  • From Keywords text file (a previously exported Keyword Library).
  • From a Media Pro Vocabulary File.
  • From Capture One Catalog/Session (extracts the Document Keyword Library from the chosen Catalog/Session file).

Adding keywords to a keyword library

If you wish to add a keyword to any available Keyword Library, shared or otherwise, without adding it to an image, click on the (+) icon next to the desired list to add a keyword. The keyword will appear in the list as passive (displayed black with a gray outline).

Editing keywords in the keyword library

To edit a keyword in the Keyword Library, right-click on the keyword and choose Rename…

To add a child keyword (hierarchical) to an existing term, right-click on the keyword and choose Create Keyword Child.

To delete a keyword from the library including any images that they are applied to, right-click on the keyword and choose Delete Selected Keywords…

To delete multiple keywords from a Keyword Library (including any images that they are applied to), hold the shift key when making a sequential selection or hold the cmd (Mac) / ctrl (PC) key for an arbitrary selection, then right click and choose Delete Selected Keywords…

Notes about editing Document and Keyword Libraries

  • Editing a keyword in the document Keyword Library will update the images in the document with those keywords.
  • Editing keywords in Shared Keyword Libraries will NOT update their respective images.
  • Session users: Editing or deleting keywords in the Session Keyword Library will only update those keywords applied to images in directories which are part of the session. These are Favorites or the Session folders (Capture, Output, Selects, Trash).

Add keywords to images in the keyword library

All Keywords listed in the Keyword Library can be added to images. Select the image or images, then click on a keyword from the Keyword Library to apply it. Keywords added here will be displayed in the Keywords tool.

When applying a keyword child to images, any parents already associated with that child will also be applied.

Remove keywords from images in the keyword Library

To remove a keyword from an image, or multiple images, using the Keyword Library, highlight the image, or images, then click on the (X) icon in the relevant keywords in the list.

The relevant keywords will be removed from the Keywords tool while the Keywords Library tool will be updated and display the changes made. Keywords removed from images will still be displayed in the library’s list but the keyword will have changed from active (solid gray) to passive (black with a gray outline).

Any active keywords (i.e., those still applied to the selected images) will be shown in both the Keywords palette and the Keywords Library tool.

Managing keyword libraries

Managing the Keyword Library – or indeed multiple Keyword Libraries – is the key to mastering quick keywording.

If a list is required for use in another workstation, or if you wish to export a document Keyword Library as a foundation for a custom Keyword Library you can export the list from the contextual menu option () in the specific Keyword Library to a text file (.txt).

This txt format can then be imported on another workstation, shared, or reimported for customization. Upon import of txt file this is converted to a .cokeywordsdb file and stored in the applications support folder.

To import a Keyword Library from another source, click on the () icon on the keyword library tool bar and then Create Keyword Library… and then an option from the fly-out menu. Capture One supports import from a variety of sources.

Supported sources:

  • Keyword TXT file (file generated by exporting an existing Keyword Library)
  • Media Pro vocabulary file
  • Catalog/session (document Keyword Library from selected Catalog/Session)

Note: When importing text files with keywords (keyword lists (e.g., from Lightroom) and Media Pro vocabulary files) the following characters are not allowed in the text file:

| ; , < >

By default Shared Keyword Libraries are stored in the application support folder:

Mac: ~/library/application support/capture one/keywords

Win: user\appdata\local\capture one\keywordlibraries

Any Keyword Library saved in these directories will automatically load into created or opened documents.

Additive metadata lists

To complement the keyword implementation, the logic of combining keyword presets has changed in Capture One to allow blending of presets in a more predictable sequence.

Tools affected are keywords and IPTC fields, where word lists are supported:

•Subject Code
•Supplemental Categories
•Getty Personality

In versions prior to Capture One 9, for example, combining the presets:




Would result in B and C being removed in the keyword list.

Capture One now combines the list in a more logical way, so that the resulting list would be:


Controlling keyword libraries on export

When exporting images, Capture One will include any assigned keywords from shared keyword libraries by default. However, you can select specific keyword libraries to limit keywords assigned to images during export. This is useful when you have a controlled vocabulary for a particular use, for example, when submitting images to a news agency or stock library.

  1. From the Output Tool Tab, select the appropriate recipe from the Process Recipes list, or create a new recipe specifically for the purpose. When the recipe is highlighted in orange, amendments will be saved automatically. (Note that if multiple recipes are to be used for export, the following selection will have to be made for each recipe.) 
  2. In the Process Recipe tool located below the recipes list, select the Metadata tab.
  3. Click on the Text field under Include Keywords, select From selected keyword libraries, and choose the relevant library from the list. Only shared libraries can be chosen.
  4. When exporting images with the controlled keywords, remember to enable the recipe in the list by selecting the checkbox.