Skip to main content

Edit a Taxonomy


You can edit the taxonomy directly in the UI or download the taxonomy, edit it in a spreadsheet application, and then upload the file.

Users with the LSH Admin, LSH CP Admin, or LSH Data Scientist personas can edit a taxonomy using the following methods:

  • Editing the taxonomy directly in the UI

  • Downloading taxonomy details in an XLSX file, editing it in a spreadsheet application, and then uploading the file


  • Only the taxonomy owner can edit a taxonomy directly in the UI. If you want to edit a taxonomy that you do not own, duplicate the taxonomy and then edit the duplicated taxonomy.

  • You cannot edit the active taxonomy. If you want to edit the active taxonomy, first make another taxonomy the active taxonomy. After editing, make the original taxonomy the active taxonomy again. See Make a Taxonomy the Active Taxonomy.

  • If you need to edit the taxonomy name or the datasets used in the taxonomy, you must edit the taxonomy in the UI. Taxonomy names and the included datasets cannot be edited via Excel file.


  • If you have data in the Analytics Environment, we recommend you do not change the segment and value names (i.e., the last "Level_Desc" folder or column and the "Value_Desc" column) because any changes you make to those columns will not be reflected in the Analytics Environment. Keeping the segment names and values the same will make it easy to decipher how Customer Profiles segments relate to Analytics Environment segments.

  • When editing field values, it is possible to duplicate an existing value. For example, if you have a field with a value of X and you change it to Y, you can have two Y values if another already Y value already existed. To prevent duplicates, review existing values before editing a field.

Procedure. To edit a taxonomy directly in the UI:
  1. In the left navigation bar, click Safe Haven and then click Taxonomies.

  2. On the Taxonomies page, select the check box for the taxonomy you want to edit.

  3. In the footer, click More and then click Edit (C_CS-edit_icon_only.jpg).

    The Edit Taxonomy page displays.


    To expand a taxonomy folder: Click the caret to the left of the folder name.


    Once you reach the field value level, no caret appears to the left of the field value name.


    Several editing controls are available in the footer area:

    • "Undo" and "Redo" buttons (S_LSH-Edit_a_Taxonomy-undo_and_redo_icons.jpg)

    • A "Download" button (S_LSH-Edit_a_Taxonomy-download_icon.jpg) to download taxonomy details if you want to edit the taxonomy via an Excel file

    • An "Upload and Replace" button (to upload an edited Excel taxonomy file)

    • A "Save Taxonomy" button

    To discard your changes and return to the Taxonomies page, click the back arrow (caret) in the upper left.

  4. To change the taxonomy name, use the Taxonomy Name field to edit the name.

  5. To remove a dataset, click the "remove" button (the minus sign) on the row for that dataset.

  6. To add a dataset:

    1. Click Dataset Selector.

    2. From the dialog that appears, expand the appropriate folder until you see the desired dataset.

    3. Select the check box for the desired dataset and then click Confirm.

  7. To add a "Level 1" folder (the equivalent of the "Level1Desc" column in a downloaded taxonomy Excel file), click Add Folder at the top of the folder tree.



    Adding a Level 1 folder is not recommended as it makes it more difficult for your users to understand where your data comes from. The Level 1 folder is at the same level as the "My Data" folder on the Audiences page and the Audience Builder page.

  8. To add a subfolder within another folder in the taxonomy tree, hover over the row for the folder you want to add the new folder into and click the "Add Folder" icon.


    You cannot add a subfolder within a folder that only contains values.

    To delete a folder you've added, hover over the row for that folder and click the Delete icon.

  9. To edit the name, description, or price for a folder, hover over the row for that folder and click the Edit icon.


    This makes the name field editable and opens a side panel where you can edit the description or price.


    To exit the folder editing options, click outside of the folder row and side panel.

  10. To edit the name for a field value, hover over the row for that field value and click the Edit icon.


    This makes the name field editable.


    To exit the field value editing options, click outside of the field value row.

  11. To move a folder or value, hover over the appropriate row and then use the Grabber icon (the six dots) that appears to drag the folder or value into the desired folder.


    The folder row that you try to drag the value or folder into will turn blue if the folder is allowed to be moved inside of that folder row.

  12. To remove a value or a folder (and all subfolders and values within that folder), clear the check box for that value or folder.

  13. Once you're done editing the taxonomy, click Save Taxonomy.

Procedure. To edit an existing taxonomy by downloading, modifying, and uploading an Excel file:
  1. From the Taxonomies page, select the check box for the taxonomy you want to download details for.

  2. In the footer, click More and then click Download (S_LSH-Edit_a_Taxonomy-download_icon.jpg).

  3. Open the downloaded Excel file.

  4. Modify the structure, following these guidelines:

    • Do not modify columns A to C (“Taxonomy_ID”, “Node_ID”, and “Level1_Desc”). If you change the "Taxonomy ID" or "Node ID" column info, the upload will fail. If you change the "Level1_Desc", the parent folder name in the UI will change, which might be confusing to your users.

    • You can modify column D (“Level2_Desc”) but use caution as this is the data set name that Safe Haven uses and it might be confusing if you change this.

    • For the level description columns, make sure not to leave any blank columns in between columns that you have filled out. For example, if you have filled out level 3 (“Level3_Desc”) and level 5 (“Level5_Desc”), “Level4_Desc” must have a value.

    • Do not give the same name for a value description (“Value_Desc”) and a folder at the same level.

    • The folder names and segment value names will be automatically sorted alphabetically on your Audiences page and Audience Builder page. Sorting the file will not affect how the folder names and segment names appear.

  5. Save the modified file in .xlsx format.

  6. From the Taxonomies page, select the check box for the taxonomy you want to edit and then click the Edit icon (C_CS-edit_icon_only.jpg) in the footer area.

  7. From the Edit Taxonomy page, click Upload and Replace.

  8. From the Upload and Replace dialog that appears, upload your file using one of the following methods:

    • Drag-and-drop your file into the upload area

    • Click Select File, navigate to the location where you saved the modified taxonomy, and select the file.

  9. Click Confirm.

  10. Click Save Taxonomy.


Your taxonomy appears directly below the active taxonomy (unless it is the active taxonomy, in which case it appears at the top of the table).