Virginia Tech® home

Tags documentation

Tags are used for search engine optimization keywords and to organie content for association or display filtering. Like all content in Ensemble they need to be created and published before they can be used. Tags have a parent-descendant tree structure. Tags have to be reapplied to pages if they are changed, for this reason it is best to keep tag structures and granularity as simple as possible. Too much granularity to tags/keywords can have adverse effects on search optimization.

Building a taxonomy

The following links provide resources for users needing assistance with creating a site taxonomy for their tags.

How to create tags

The My Tags interface accessible through the main Navigation menu by clicking on the Ensemble link in the black eyebrow menu, provides the means for creating and managing tags for search keywords and content organization.

From the main Navigation menu, choose My Tags.

My Tags navigation button
My Tags navigation button

Select the site you wish to create tags for from the left column.

My Tags choose site from left column
My Tags choose site from left column

Click the Create button to begin.

Create tag button
Create tag button

Add a mixed case Title and a lowercase Name to the tag creation dialog.

Click the Submit button to save the tag.

Repeat the process to create as many parent and descendant tags as needed for your taxonomy.

New Tag creation dialog with name, title, and description input fields
New Tag creation dialog with name, title, and description input fields

How to modify existing tags

Selecting a tag item

Tag selected actions menu
Tag selected actions menu

This actions menu is very similar to the others, with Publish, Unpublish, and Delete having obvious functions. Unpuiblishing a tag will also unpublish any descendant tags. There is no restore feature for tags if deleted. The create button creates a child tag to the selected tag.

Edit: Edit a tag's title and description.

NOTE: You cannot modify a tag's name property. You will need to create a new tag and retag content if the Name property must be changed.

Tag edit dialog
Tag edit dialog

Move: Do not move tags. You will need to retag after moving and republish everything with the old tag(s) anyway. Just create a new tag before removing the old one so you can easily find all content needing the new tag. Then remove the old tag as you go until all content has been retagged. Delete the old tag in the previous location only after all pages have been retagged..

Tag move dialog
Tag move dialog

Merge: Merge two tags into a single tag.

Tag merge dialog
Tag merge dialog

How to use tags

Users can use tags within the system by applying them to pages and then using them to build lists of content.

Applying tags to pages

In the Basic page properties either while creating a page or editing, there is a Tags selection field where multiple tags can be individually added to a page.

You can type into the Tags input field, copy-paste a mixed case tag Title, or use the tag selection interface to add tags.

Remember to save the changes if editing an existing page and republish the page after adding tags.

Tagged pages can now be filtered into content lists within the system for display on other pages that may be related.

Example Basic page properties with tags
Example Basic page properties with tags

Building lists using tags

The List component allows for content lists to be built based on a tag or set of tags.

Select the tags you want to use to build the content list.

Select whether ANY ("or" association) or ALL ("and" association) tags need to be on a page to be displayed in the content list.

Example List component configuration for tag filtered list
Example List component configuration for tag filtered list

The content list should show only the pages matching the tag association.

Example list component built from tags in page
Example list component built from tags in page

Building related content using tags

Along with the Tags selector in the Basic page properties, there is the Related Tags field. This field allows for pages that match these tags to be displayed on this page from a larger pool of pages.

Example Basic page properties with tags
Example Basic page properties with tags

A Related Content component on the page will use this set of tags instead of the potentially larger set of page tags to focus on specific related content.

Related Content component configuration example
Related Content component configuration example

This is useful for displaying related content without having to build a specific list for each page by using inherited content drop zones.

Related Content components in inherited content drop zone
Related Content components in inherited content drop zone
Example related content from tags in page
Example related content from tags in page