Tags are labels that serve two separate purposes in the platform: to help you keep your assets organized and as a tool to provision content across the platform, like in Panorama and in Dynamic Widgets.
Use Case Information
Tagging is a great way to organize assets in the native content authoring interface, Asset Library, Panorama, and more so that you can quickly sort and access tagged items.
Note
Tags are private and only displayed in the management interface; they are never visible to learners.
When configured you can control the following:
- Use tags as a filter in the content authoring interface to call up all content labeled with a specific tag
- Greatly decrease the time spent provisioning individual content items since you can attach a single tag to many content items, then subsequently use the tag to provision all tagged content with a single action
- In Panorama, assign tags to each Panorama client to keep the Panorama interface organized and report on groups of Panoramas
- In the Asset Library, use tags to keep your assets organized
Note
Read more about how to use the Asset Library to add assets to content here.
Where to Use Tags in the Platform
Below are the locations in which you can apply tags for content provisioning, or locations of where they can be used as an organizational tool in the platform.
Using Tags to Organize Content
Use tags in these locations to manage and organize your content or other assets. You can then use the tags to easily find items and filter your lists.
Content Interface
Go to Courses > All Courses OR Events > All Events.
You can use tags to quickly find courses, videos, learning paths...basically, ANY content you've authored, as long as you have tagged your content accordingly. A Tag Filter is available on the Courses and Events list.
Asset Library
Go to Courses > Asset Library.
A Tag Filter is available on the Asset Library list to find and manage your assets quickly.
Panorama Interface
Go to Panorama. To set a tag in a panorama for organization, go to Panorama > Settings > Primary.
A Tag Filter is available on the Panorama list. For these organizational tags, look for the Client Tag filter.
Ecommerce Products
Go to Ecommerce > Products. When creating any eCommerce item, you have the option to assign an organizational tag.
A Tag Filter is available on the Ecommerce Products list. This will filter your Ecommerce Products based on these organizational tags so that you can find items and manage them quickly.
Note
Tags provide long-term content and area management, but require planning. Your individual tag strategy should meet your organization's needs as your libraries grows and your organization needs evolve. Be sure your team is aligned on your tag strategy for a seamless work flow.
Using Tags to Provision Content
Provisioning typically means giving access to content inside of a panorama - it's the content a logged in panorama learner will see in a catalog widget for example. But it can also mean displaying content dynamically in design layouts.
Widget Interface
Use tags to provision content to various widgets by adding a tag-specific search query. Widgets can be added to various layouts by visiting Site > Site Builder > Layouts or Pages.
For example, you could have a widget to feature new content on your homepage. If you've added a tag-specific query to the widget, instead of having to redesign the widget each time you wanted to update the displayed content, you could just add and take away a tag from content items.
If you do reference tags in queries (like in a catalog widget for example), the query needs to match exactly and is case sensitive. For example, if my tag is Food
, my query should be tags:Food
. tags:food
will not work.
Because these queries are manually entered, there is no way to view where your tags are used in Widgets in the UI. We highly recommend managing this via Tag Descriptions in Tag Manager or outside of the platform.
Panorama Interface
Use tags to provision content to Panorama learners by visiting Panorama > Settings > Access.
You can also provision content to a Panorama as Purchasable Content in this same area.
Tag Filters are available on the Panorama list for Content Tag and Purchasable Tag. This way you can see which panoramas are affected by tags you have provisioned for your learners to have access.
You might create packages of content with tags, such as a Basic Package and Premium Package. You can assign a Basic Package tag to a given Panorama client while assigning the Premium Package tag to a different Panorama client, based on each client's contracted content access. Each client would then only see the content associated with their respective tag, which helps avoid human error and allows you to quickly and easily assign a group of content to the right learners.
Ecommerce Subscriptions
Save time by using tags to pull content into your subscriptions, instead of manually adding it. The prerequisite to this is already having your content tagged. Once your content is tagged appropriately, go to Ecommerce > Products > Select Your Subscription > Actions > Edit. Scroll down the page and fill in the Content Tags field with the tags from the content you want to pull into your subscription.
Outside of going into each Subscription, there is no way to filter on where your tags are used in Subscriptions in the UI. We highly recommend keeping track of this via Tag Descriptions in Tag Manager or outside of the platform.
Recommendation Assessment
When creating this assessment, you'll assign content tags to the answer choices. After completing the assessment, learners will be presented with content based on their selected answers and the corresponding tags.
Go to Courses > Settings > Recommendation Assessment. See this article for more information about the Recommendation Assessment.
There is no way to filter on where your tags are used in Recommendation Assessments in the UI. You can always go into each Recommendation Assessment to view or edit the tags that are used. Because of this, we highly recommend keeping track of this via Tag Descriptions in Tag Manager or outside of the platform.
Tip
See below for examples of how clients use tags to categorize content:
Content Development Stage: WIP, Needs Review, Ready to Publish, Evergreen vs. Expires in Q2
Content Packages or Bundles: Basic, Premium, Silver, Gold
Client Life Cycle Stage: Prospect vs. Trial, Customer or Onboarding vs. Launched
Client Size: Small, Mid, Enterprise
Client Type: Freemium Client vs Paid Client
Role/Department: Internal, External, IT, Sales, Support
Content Assets: audio recordings, Wistia Media ID, images*
Learner Role: Associate vs. Manager vs. Internal Learner
Location: Ireland, America, Massachusetts, EMEA
Other: Franchise ID or other ID number
Vertical: Engineering, Hospitality, Manufacturing, Construction
*You might use tags to note what is in contained in a given content item. For example, you might apply a tag that reads "dashboard" to indicate there are images of your software's dashboard so you know where you used that particular image. (Better yet, use CAM to manage frequently-used assets!)
Tag Manager
Admins and other roles with the required permissions can easily view, create, edit, and delete tags from a central location in Tag Manager. Tag Manager is accessible under Settings > Tags for Admins and users with the Manage Tags permission. Although you can assign tags in various places throughout the platform, this is the only interface where you can take these specific actions on tags.
You can also search for tags from this page. Tags are "search as you type" and it does not tokenize non-alphabetic characters for search, meaning you should try to search with your letters, not solely numbers.
Keep reading to learn more about how to manage tags!
Tip
Using the provided description box when creating or editing a tag can help you track the tag's purpose and where it's being used.
Creating New Tags
Tags can only be created in the Tag Manager. Keep the following in mind when creating labels for your tags:
- Labels must be unique and they are not case sensitive
- Cannot be a label being used for an existing tag or content folder
- Must contain at least ONE alphabetical character
- Cannot contain these special characters:
- Double quote (")
- Backslash (\)
To create a tag:
- From your homepage, select Settings > Tags.
- Select the + icon in the upper right corner of the page.
- Create a Label for your tag.
- Create an optional Description for your tag.
- Click Save.
Editing Tags
In Tag Manager, Managers can edit the tag label, which will update the label everywhere the tag appears across the platform, with one exception: content or catalog queries will not automatically update. Managers, however, will be notified that they must manually update any queries referencing the old label.
In addition to editing tag labels, the optional description field can also be modified. This field is useful for storing information such as where or why tags are being used.
To edit a tag and/or a tag description:
- From your homepage, select Settings > Tags.
- Click the Tag Label to open the tag for editing.
- Click on the Label and/or Description field to begin editing.
- Click Save.
Note
When users save a new tag label, this will automatically change the Updated At date on all associated content (this excludes Learning Paths where the date will not change).
Deleting Tags
Deleting tags are quite intuitive in Tag Manager, however, here are some things to keep in mind:
- Deleting tags is a global action and will automatically remove the tag from all objects where it’s been assigned (e.g. content, panoramas, events, etc).
- All content and catalog queries that reference this tag will need to be manually updated.
- After a tag is deleted, users can create a new tag in the future with the same label. The new tag, however, will have a new tag ID + will not be associated with any objects upon creation.
To delete a tag:
- From your homepage, select Settings > Tags.
- Click on the Tag Label of the tag you wish to remove.
- From the pop up, select the trash can icon.
- From the confirmation pop up, select Yes, delete this tag.
- The tag will automatically be removed from your tag list.
Warning
Deleting a tag is a permanent action and cannot be undone. Prior to deleting a tag, Admins should review where the tag is assigned to understand the implications, such as impacts to panorama and content access.
Adding Tags to Content
You can individually add existing tags to your items, or for the content list, you can automate the process by bulk adding tags. When bulk adding, select up to 100 pieces of content and up to 10 tags at once for more efficient and streamlined content management. Here’s how:
Bulk Adding Existing Tags to Content Items
- From your homepage, select Courses > All Courses.
- View the main content list or the content list within any folder.
- Select the checkbox next to any piece of content or choose all content on the page (up to 100 items) to apply the tag.
- From the bulk actions menu that appears after selecting the checkboxes, choose the Tag option.
- In the pop-up menu, enter the tag name in the Search and select tag (s) field and check the boxes next to the tags you wish to apply.
- After selecting all the desired tags, click the Add Tags button.
- You will be redirected to your content list, and the action will be complete.
Note
If a selected course already contains the tag being added, there will be no change to that course. The bulk action can still be performed without any errors.
Individually Adding Tags to Content Items
- From your homepage, select Courses > All Courses.
- Select the content item you wish to add a tag.
- Select the Design step > Edit Catalog Settings.
- Click the Tags container and select the tag you wish to attach to the content item. Alternatively, type the tag name into the Tags bar and select it from the drop-down.
- Add as many tags as you need to.
- Click Save.
Removing Tags from Content
You can individually remove existing tags from your items, or for content, you can automate the process by bulk removing tags. Select up to 100 pieces of content and up to 10 tags at once for a more efficient and streamlined content management experience. Here’s how:
Bulk Removing Tags from Content Items
- From your homepage, select Courses > All Courses.
- View the main content list or the content list within any folder.
- Select the checkbox next to any piece of content or choose all content on the page (up to 100 items) to remove the tag from.
- From the bulk actions menu that appears after selecting the checkboxes, choose the Tag option.
- In the pop-up menu, enter the tag name in the Search and select tag (s) field and check the boxes next to the tags you wish to have removed.
- After selecting all the desired tags, click the Remove Tags button.
- You will be redirected to your content list, and the action will be complete.
Note
If you attempt to remove a tag from content that didn't have it originally, your changes will still be saved successfully without any error message.
Individually Removing Tags From Content Items
- From your homepage, select Courses > All Courses.
- Select the content item you wish to remove a tag.
- Select the Design step > Edit Catalog Settings.
- Find the Tags container and click the X on the chosen tag or simply delete text from the Tags bar with your delete or backspace key.
- Click Save.
Tags in Reports
Tag views are available during custom report creation to filter data by tags. Here are some key points to note:
- When Admins edit a tag label in the Admin UI, it may take a few hours for the updated label to reflect in reporting.
- Folders (created on the content or events list in the Admin UI) will also display within the same list of tags in reporting.
- When Admins delete tags in the Admin UI, these deleted tags will still continue to show up in reporting.
Let's look at the tag views available in reporting:
Content Tags View
- Use the Tags dimension to add a new column or filter.
- Available on base configuration explores that contain the Content Details or Learner Content Details view:
- Transactions (Site)
- Assessments (Site)
- Certificates (Site)
- Learner Content & Progress (Site)
- Content Actions Log (Site)
- Learners (Site)
Learning Path Tags View
- Use the Label dimension to add a new column or filter.
- Available on base configuration explores that contain the Learning Path Details view:
- Competency Assessment Attempts (Site)
- Learning Path Actions Log (Site)
Client Tags View
- Use the Label dimension to add a new column or filter.
- Available on base configuration explores that contain the Panorama Details view:
- This applies to all custom report explores.
Content Tags Update: December 10, 2024
Our reporting suite is designed to give admins extensive access to a wide range of data from our production database, empowering you to manage your business and track the metrics that matter most. With such a robust tool, uncovering limitations as we expand data access is part of the process.
In this vein, we are aware of the following limitations in Content Tag Reporting and are actively working on solutions:
-
Assigning Content Tags to Pre-Existing Content
When a tag is assigned to content that was created in the past, the course is not always updating correctly in the reporting database. While the new tag appears as expected in the UI, it may not reflect in reports. -
Removing Content Tags or Deleting Tags via Tag Manager
These actions are tied to our ongoing Deletion Governance Project, which addresses how deleted or updated data is handled across systems. Improvements will be implemented once the coursetags and tags tables include the new Status Group column and this updated data is available in Reporting Hub.
Content tags affect all content types, except for learning paths. Learning Path tags and Client tags are currently working correctly at this time and are not affected by the limitations outlined above.
We recognize these issues can impact your reporting workflows, and we appreciate your patience as we work to improve. These limitations reflect our commitment to exposing more data and enhancing the depth of our reporting capabilities. Resolving these challenges is part of our broader effort to ensure the reporting suite delivers the accuracy and flexibility you need.