Tags that can be applied to content are organized into hierarchical taxonomies. Currently, the only way to create or modify a taxonomy is by uploading a CSV or JSON file.
The simplest type of taxonomy is a flat taxonomy that doesn’t have any hierarchy - see “How-to: Create a flat taxonomy by uploading a CSV” for a simpler procedure to create such a flat taxonomy. For the purposes of this guide, we’ll assume you want to create a taxonomy of cities, like this:
United States
California
Los Angeles
New York
New York City
Mexico
Mexico City
First, review your proposed taxonomy. Note that each tag must have a unique name (across all levels of the hierarchy). So, for example, we could not have “New York” as both a second-level (state) tag and third-level (city) tag - we have to rename one of them (e.g. “New York City” in this case)
Navigate to Studio Home > Taxonomies. You should see Download Template in the top right. Click on that button, then select “CSV template”.
A file will download automatically. Open it using any spreadsheet application (Excel, Numbers, Google Sheets, etc.).
TODO: finish writing this section-----
The “id” for each tag is required, but mostly relevant when you are aligning your taxonomy with some external system that uses IDs for each tag. If you don’t have that use case, just enter the same text for the id as for the value.
Save the spreadsheet using the default format, in case you want to edit it later.
Export the spreadsheet to a CSV file.
In Excel, use File > Save As…, and set the “File format” to “CSV UTF-8 (comma-delimited) (.csv)” (preferred) or “Comma Separated Values (.csv)” then enter a filename and save it.
In Google Sheets, use File > Download > Comma Separated Values (.csv).
In Numbers, use File > Export To > CSV… and use the default options.
Navigate to Studio Home > Taxonomies and click on the Import button at the top right of the screen.
When prompted, click to select the CSV file from step 4 and upload it.
When prompted, enter a name for the new taxonomy:
When prompted, enter a description for the taxonomy (recommended but optional).
Then keep the page open until you get this message:
Find your taxonomy in the list of taxonomies, and click on it to verify the results:
