Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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. For example, if you want to tag the “difficulty” of problems as either “Easy”, “Medium”, or “Hard”, you could do that by creating a flat taxonomy. Here’s how to do that:

1. Open any spreadsheet application (Excel, Numbers, Google Sheets, etc.) and create a new blank spreadsheet. In the first row, add two columns called id and value.

...

  1. Below that, enter the new tags that you want to create in the “value” column, and give each tag an ID in the “id” column. 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.

Image Added

  1. Save the spreadsheet using the default format, in case you want to edit it later.

  2. Export the spreadsheet to a CSV file.

    1. 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.

    2. In Google Sheets, use File > Download > Comma Separated Values (.csv).

    3. In Numbers, use File > Export To > CSV… and use the default options.

  3. Navigate to Studio Home > Taxonomies and click on the Import button at the top right of the screen.

    Image Added

  4. When prompted, click to select the CSV file from step 4 and upload it.

  5. When prompted, enter a name for the new taxonomy:

    Image Added

  6. When prompted, enter a description for the taxonomy (recommended but optional).

  7. Then keep the page open until you get this message:

    Image Added

  8. Find your taxonomy in the list of taxonomies, and click on it to verify the results:

    Image Added