How-to: Update/Re-import a taxonomy

Owned by
Jenna Makowski
Last updated: May 21, 2024
2 min read

In order to update taxonomies, they must be updated locally and re-imported. This document walks through that process.

Updating a taxonomy locally

Before a taxonomy can be re-imported, it must be updated locally. Here’s how to do that.

  1. Export the taxonomy you wish to update. See here for instructions on how to export.

  2. Open the file locally. It should look like this:

Screen Shot 2024-05-21 at 2.32.26 PM.png

  1. Find the tag value that you wish to modify. Only tags in the “Value” column should be changed.

Screen Shot 2024-05-21 at 2.34.30 PM.png

Note: DO NOT change the tag id. This will render the taxonomy un-usable. Here’s why you shouldn’t change the tag id.

  1. Once you’ve finished making changes, export the file as a CSV or JSON file and navigate back to the Taxonomy Dashboard.

  2. Find the taxonomy you wish to update. Click on the three-dot menu and click on “re-import”.

  1. You will be prompted with an option to export and save a copy of the taxonomy in its current state, before updating it. During the update process, the current taxonomy will be replaced with the updated version, and its advisable to keep a copy of the current version in case something goes wrong in the updating process.

  2. After exporting a copy of your taxonomy in its current state, click next.

  3. Find your local file, upload, and click import.

  4. You will be prompted to accept a list of changes. If everything looks ok, click “continue”.

  1. You will be prompted with a notification when the re-import is complete.

  2. To view your newly imported taxonomy, find the taxonomy card in your taxonomy listing and click the title. You will see your taxonomy and all its associated tags in the taxonomy view page.