Support and Documentation


Tags are words or short phrases associated with items. 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.

How tags help visitors discover content

The following diagram illustrates the relationship between a tag associated with an individual item and all items associated with a tag.


In the article to the left, there is a single tag Local composting associated with the article. When a visitor clicks on the tag to discover additional content associated with Local composting, Brightspot delivers the corresponding tag page. The page includes a description of the tag as well as the two items associated with the tag.

Examples of tags and taxonomies

A collection of tags is a taxonomy. The following table provides examples of taxonomies for different types of publications.

Table 20. Examples of taxonomies

Publication type



Names of politicians—Thomas Jefferson, Winston Churchill

Issues—Education, Foreign Relations, Transportation


Names of athletes—Babe Ruth, Hank Aaron

Names of sports—Baseball, Football, Hockey


Names of celebrities—Greta Garbo, Gérard Philipe

Names of movies—Citizen Kane, The Gods Must Be Crazy


Names of subjects—English, Law, Economics

Names of professors—Maya Angelou, Stephen Hawking, Ludwig von Mises

Understanding tag hierarchy

Referring to the table Examples of taxonomies, a political publication 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.

Tag hierarchy
Figure 65. Tag hierarchy

Referring to the previous illustration—

  • Issues is a parent tag of Education, Transportation, and Foreign Relations (reflecting the example in the table Examples of taxonomies).

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

Creating a tag
Procedure. To create a tag:
  1. In the dashboard, in the Quick Start widget, click Tag. A New Tag content edit page appears.

  2. Using the table Fields for defining a tag as a reference, enter values in the fields.

  3. Complete your site's workflow and publish the tag.

Table 21. Fields for defining a tag



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 Understanding tag hierarchy.


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.


If configured, Brightspot displays the lead instead of the description in the tag's page.


If configured, Brightspot displays the content instead of items associated with the tag in the tag's page.

. See also:
Viewing a tag hierarchy
Uploading tags

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

Procedure. To upload tags:
  1. In the header, click |mi-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 Fields for defining 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).

. See also: