Support and Documentation

Tags

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.

tag-page-diagram.svg

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 12. Examples of taxonomies

Publication type

Taxonomy

Politics

Names of politicians—Thomas Jefferson, Winston Churchill

Issues—Education, Foreign Relations, Transportation

Sports

Names of athletes—Babe Ruth, Hank Aaron

Names of sports—Baseball, Football, Hockey

Entertainment

Names of celebrities—Greta Garbo, Gérard Philipe

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

University

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 45. 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. Contact your Brightspot representative if you would like to automatically assign children tags to an item.

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 13. Fields for defining a tag

Field

Description

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.

Description

Tag's description.

Parent

Tag's parent in the tag hierarchy. For more information, see Understanding tag hierarchy.

Hidden

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.

Lead

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

Content

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



. See also:
Viewing a tag hierarchy

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

Procedure. To view a tag hierarchy:
  1. In the dashboard's header, click in the search field to open the search panel.

  2. From the 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 |mi-chevron_right| for a tag to view its children.

tag-hierarchy-search.png

Referring to the previous image, the search panel shows the hierarchy corresponding to the illustration 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 dashboard's header, click in the search field to open the search panel.

  2. In the Create widget, select Tag CSV Importer, and then click New. The New Tags CSV Importer 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: