Use tags to organize

Tags enable you to create categories for classification of objects, including Liveboards, answers, data sources, and worksheets.

You can create tags to make it easier for people to find data sources and Liveboards. Tags are global in scope. This means that everyone can see the tags and use them to tag objects. They can also filter lists of objects by tag. Tags are often used to designate subject areas, such as sales, HR, and finance, but you can use them any way you like.

Keep in mind these permissions when working with tags:

  • Only administrators can create tags.

  • Anyone who has edit access to an object can apply a tag to it.

  • Anyone can filter by a tag.

  • You can only filter by one tag at a time from the UI.

Create a Tag

Only administrators can create tags. Anyone can apply the tags you create, or use them as filters when selecting from a list of sources or Liveboards.

Create a tag from the Answer or Liveboard page

To create a tag from the Answer or Liveboard page, follow these steps:

  1. Select Answers or Liveboards from the top navigation bar.

  2. Click the currently selected tag, or click Select tag, scroll to the bottom of the list, and click + Add.

    Add a tag
  3. Type the name for the new tag.

  4. You can change the name of a tag by clicking the edit icon next to its name.

    Edit a tag
  5. You can change the color of a tag by clicking the color circle next to its name.

    Edit a tag color

Create a tag from the Data workspace

To create a tag from the Data workspace, follow these steps. Note that you must be an administrator to create a tag.

  1. Select Data in the top navigation bar.

  2. Select the empty checkbox next to an object that you would like to tag.

  3. Select Edit tags from the options at the top of the object list.

  4. The Edit tags modal appears.

  5. Type the name of the tag you would like to create.

  6. Select + Add tag `<tag name>`.

    Select + Add tag
  7. Type the names of any additional tags you would like to create, and select + Add tag `<tag name>`.

  8. If you would like to create the tag without adding it to the object(s), select Cancel in the Edit tags modal. If you would like to create the tag and add it to the object, select Save in the Edit tags modal.

Apply a tag

Only administrators create tags, but anyone with edit privileges can tag an object with a tag. The workflow for applying a tag is different depending on the type of object:

Apply tags to answers or Liveboards

To tag an answer or Liveboard with a tag, follow these steps:

  1. From the top menu, choose Answers or Liveboards.

  2. Find the item(s) you want to tag in the list, and check the box next to its name.

  3. Click the apply tag icon and choose one from the list. You can apply as many tags as you like to an object.

Apply tags to tables, worksheets, views, or SQL views

To apply a tag to a table, worksheet, view, or SQL view, follow these steps:

  1. From the top navigation bar, select Data.

  2. Select the checkbox next to the name of the object(s).

  3. Select Edit tags from the options at the top of the object list.

  4. The Edit tags modal appears. To see all tags, click anywhere in the text box of the modal. To narrow down the results in the dropdown, start typing. For example, type sales to see all tags related to sales.

  5. Select a tag. You can continue to add tags as necessary.

  6. Select Save.

Filter by tags

Whenever you are selecting objects from a list, you can filter by a tag to find what you’re looking for. Anyone can use tags to filter lists of Liveboards or data sources. You can also filter by tag when selecting data sources.

Note that you can only filter by one tag at a time in the UI. To get a list of ThoughtSpot objects or object headers that is filtered by multiple tags, use the Metadata API. The list and listobjectheaders endpoints allow you to filter by multiple tags.

To filter by tag:

  1. From the top menu, choose Answers, Liveboards, or Data.

  2. On the Answers or Liveboards pages, click Select tag, and select the name of the tag you want to filter by.

    Filter by a tag

    On the Data workspace home page, select the All tags dropdown, and select the name of the tag you want to filter by.

    Select a tag from the dropdown

Remove a tag filter

To remove a tag filter and see all objects again, select the tag you filtered on in the tag list.

Remove a tag

You can remove a tag from an object from the object list page, for Answers and Liveboards, or the Data Workspace home page, for tables, Worksheets, views, and SQL views.

To remove a tag for an Answer or Liveboard, follow these steps:

  1. Navigate to the Answers or Liveboards page, from the top navigation bar.

  2. Select the x that appears when you hover over the tag name for the object.

To remove a tag for a table, Worksheet, view, or SQL view, follow these steps:

  1. Navigate to the Data workspace by selecting Data from the top navigation bar.

  2. Select the checkbox next to the name(s) of the object(s).

  3. Select Edit tags from the options at the top of the object list.

  4. The Edit tags modal appears. Select the x next to the tag(s) you would like to remove.

  5. Select Save.