How-to guideGet a task done

Manage taxonomy

This guide explains how to create and maintain the keyword categories and keywords that make up your taxonomy, and how to apply a keyword to an asset. For background on how taxonomy works, see Understanding taxonomy.

Prerequisites

Before you begin, ensure you have:

  • Admin access to the Taxonomy section of Administration.

In the Taxonomy screens, a category of keywords is called a genus.

Create a category and keywords

  1. Navigate to Administration > Taxonomy.

  2. Select Create New Genus.

  3. Enter a name for the category, such as "Season" or "Year".

    You can optionally add localised names for other languages.

  4. Add keywords, separating them with commas or new lines, then press Enter.

  5. Select Save.

The category and its keywords are available to apply to assets straight away.

Commas are the simplest separator. To add a new line without submitting, press Shift+Enter.

Add keywords to an existing category

  1. Navigate to Administration > Taxonomy.

  2. Open the relevant genus.

  3. Add the new keywords, then select Save.

Apply a keyword to an asset

  1. Open the asset in Administration.

  2. In the right-hand panel, select the keywords area and type to find a category.

  3. Select the keyword to apply it.

Changes save automatically.

To apply keywords to many assets at once, see Tag and edit asset metadata.

Edit a keyword

  1. Navigate to Administration > Taxonomy.

  2. Open the relevant genus.

  3. Select the keyword to edit it inline, then select Save.

Renaming a keyword updates it on every asset it is applied to. For example, renaming "Blue" to "Dark Blue" changes the tag on all affected assets immediately. Take care when doing this on a live platform.

Delete a keyword

  1. Navigate to Administration > Taxonomy.

  2. Open the relevant genus.

  3. Delete the keyword.

Deleting a keyword removes it from every asset it is applied to. There is no soft delete, archive, or warning, and lenses that relied on the keyword may return fewer results or none.

Before deleting a keyword, check how many assets use it, and consider re-tagging those assets with an alternative keyword first.

Domain scope

Taxonomy is scoped to the domain it is created in. Keywords created in a parent domain are visible in its child domains, but keywords created in a child domain are visible only within that child. For a single-domain setup this has no practical effect; it matters mainly where an organisation uses subdomains.

Related pages