Import & export tags
If you need to create or edit a large number of tags, doing each individually can become tedious. As a solution, we offer a Microsoft Excel (.xlsx file extension) spreadsheet template that you can import to create and edit multiple tag definitions at once. Click here to download the tag import template. You are also linked to it from the import function in the live app.
Each row in the template defines one tag, with each column corresponding to one aspect of its definition. Fill out the columns of each row as detailed below (entries are not case-sensitive):
|Tag Title||Parent Tag Title||Allow Manual Tagging||Allow Audio Tagging||Allow Image Tagging||Alternate/Alias 1||Alternate/Alias 2||Alternate/Alias 3|
|Enter name of tag definition.||Enter another tag to define this row’s tag as its child.||Enter TRUE to enable manual tagging, or FALSE to disable.||Enter TRUE to enable audio tagging, or FALSE to disable.||Enter TRUE to enable image tagging, or FALSE to disable.||Enter an alternate tag.||Enter a second alternate tag..||Enter a third alternat tag.|
Note: The Parent Tag Title and Alternate/Alias columns are options. The rest are required - if left blank, the row will not successfully import.
If you want to use the template to edit existing tags, you should export your current tag dictionary to the template, make edits (and add new rows for any new definitions), save and import. Your changes will override the former tag properties saved in the app.
Import new tag definitions
- From the Tags view, click the Import taskbar icon to open this pop-up:
- Click the Browse button to select the filled out template from your computer.
- Click the Import button to upload the template and its contained tag definitions. This pop-up will appear in the upper right corner of the screen once your tags have imported:
Click the View Report button to view the number of tags that were created or updated in the import.
Note: if you exported a tag dictionary and made edits to existing tags, the report will return the total number of tags/rows in the import spreadsheet, even if you only made edits to a few rows. This is because the system "overrides" even an unchanged tag as a new/updated tag when you import. So don't be alarmed if you export a 105-tag dictionary, edit rows for just 3 tags, and re-import to see this report:
- If one or more of the tag titles or alternates you entered in the template already exists, the pop-up will instead say "Tag Import Failed". Clicking View Report will show you the tags that returned errors. You will need to edit these tag names in your template, or delete the existing duplicate tags from the tree, before you can successfully re-import.
Exporting the tag dictionary
You can use the Export icon to export all the definitions in a project's tag dictionary to template form. This can be useful if you need to bulk-edit the properties of several tags at once, or for copying tag definitions to another project.
- Click the Export icon to prepare the tag dictionary template for export.
- When the dictionary template is ready for download, you'll see this notification in the upper right corner of the screen:
Click the Download button to save the exported dictionary as an .xlsx to your computer's Downloads folder.
To make changes to the alternates, parent/child hierarchy, or tagging behaviors of several tags, edit the exported spreadsheet, save it with with your changes, then re-import to the project. Your edits will override the previously saved tag definitions.
You can also use the template to bulk-copy some or all of the exported tags to another project, without having to recreate each one manually. Open the exported file and delete the rows of any tags you don't want carried over. Save any edits to your computer, then re-import the spreadsheet into the other project's Tags view.