In This Guide

Tags are words or short phrases associated with assets. Tags help visitors discover content on your site. For example, you can apply the following tags to an image of the moon: moon, space, Apollo, and NASA. Visitors who search for those tags will discover your image.

Creating a tag

To create a tag:

  1. In the header, click add.
  2. From the Create list, select Tag. A content edit page appears.
  3. Using the table below as a reference, enter values in the fields.
  4. Complete your site's workflow and publish the tag.

Fields for defining a tag:

Main tab
Display Name

Tag's name as it appears in your published content.

Hide Display Name

Hides the tag's display name in search results.

Internal Name

Tag's internal name that appears in Brightspot, such as in the search panel.


Tag's description.


Tag's parent in the tag hierarchy. For more information, see Explanation of tag hierarchies.


Hides the tag from your published content. This tag is useful in the following situations:

  • Visitors click on tags to discover associated content. If you have only one or two items associated with a tag, the visitor may not find anything interesting.
  • Brightspot can perform additional processing based on a tag. For example, if you tag items Premium, then Brightspot can display a pay wall for subscribers to log in before viewing the content. In this scenario, the tag Premium is hidden because it does not help visitors discover content.


A one-off module or a shared asset (including a shared module). If configured, Brightspot displays the lead instead of the description in the tag's page.


A one-off module or a shared asset (including a shared module). If configured, Brightspot displays the content instead of items associated with the tag in the tag's page.

Importing tags

You can import tags from an external file. Using this feature may be easier than adding tags individually.

To upload tags:

  1. In the header, click add.
  2. From the Create list, select Tag CSV Importer. A content edit page appears.
  3. Click Download CSV Template. Your browser downloads a CSV file. The columns in the CSV file correspond to some of fields in the table Creating a tag.
  4. Populate the CSV file.
  5. In the New Tags CSV Importer content edit page, click Choose, and navigate to your populated CSV file.
  6. In the editorial toolbar, click Import.

Brightspot imports the tags, and displays the results in a log file.
Brightspot uses the following validation rules when importing tags:

  • Display Name is a required field; all other fields are optional.
  • Display Name must be unique in the CSV file and not already exist in Brightspot. If a display name occurs more than once, Brightspot imports the first occurrence and flags the other occurrences as an error.
  • If the URL field is blank, Brightspot creates it from the Display Name field.
  • If the SEO Title field is blank, Brightspot creates it from the Display Name field.
  • If the SEO Keywords field has more than one keyword, separate them with a comma (White Roses, Red Roses).

Explanation of tag hierarchies

A political publication, for example, can have several tags grouped under Issues, one of which is Transportation. If your publication publishes five or 10 items a year in the category of transportation, then a single tag is sufficient for all of them; a visitor can easily scan the list of publications associated with Transportation and find the one of interest.

However, suppose you have a high-volume site that publishes a dozen items every day pertaining transportation. A visitor looking at the tag page Transportation will find hundreds of matching items with little chance of finding the desired item. In this scenario, you can help your visitors by providing more specific tags, such as different modes of transportation. To better manage large numbers of tags, you can organize them into a hierarchy.

Example of a tag heirarchy.png

Tag hierarchy

Referring to the previous diagram—

  • Issues is a parent tag of Education, Transportation, and Foreign Relations.
  • Transportation is a parent tag of Railroads, Airports, and Highways.

If you associate a parent tag with an item, Brightspot does not automatically assign the children tags.

Viewing a tag hierarchy

Viewing tag hierarchies can help you manage large numbers of tags.

To view a tag hierarchy:

  1. In the header, click in the search field. The search panel appears.
  2. From the Global Filters widget, select Tag, and select other search criteria as required. Brightspot displays the list of matching tags.
  3. Click the Taxonomy tab.
  4. Click chevron_right for a tag to view its children.

    Only those tags that have children will have the chevron_right.

    Tag Heirarchy

    Referring to the previous image, the search panel shows the hierarchy corresponding to the illustration found in the Explanation of tag hierarchies topic.

Select Watching to see only those tags that you have selected to watch on the Content Edit page.

Tag Watching Field