ITagQuery
Working with tags in Umbraco
The ITagQuery
interface is your primary way to work with tags in Umbraco. This interface allows you to get different tags, such as content tags and media tags. It also lets you retrieve content by tag, for instance, getting all content nodes with the "Umbraco" tag.
How to reference ITagQuery
If you're using it in Views or Partial views you can inject ITagQuery
using the @inject
keyword, for example
After this you can use _tagQuery
to access the ITagQuery
.
If you're using it in controllers, you can inject it into the constructor like so:
ITagQuery
is a scoped service, meaning that it should only be injected into scoped or transient services. For more information see the official Microsoft Documentation
Examples
All examples are from a view using the injection shown above, but working with tags in controllers will be the same.
GetAllContentTags([string tagGroup])
Get a collection of tags used by content items on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
GetAllMediaTags([string tagGroup])
Get a collection of tags used by media items on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
GetAllMemberTags([string tagGroup])
Get a collection of tags used by members on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
GetAllTags([string tagGroup])
Get a collection of tags used on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
GetContentByTag(string tag, [string tagGroup])
Get a collection of IPublishedContent by tag, and you can optionally filter by tag group as well
GetContentByTagGroup(string tagGroup)
Get a collection of IPublishedContent by tag group
GetMediaByTag(string tag, [string tagGroup])
Get a collection of Media by tag, and you can optionally filter by tag group as well
GetMediaByTagGroup(string tag, [string tagGroup])
Get a collection of Media by tag group
GetTagsForEntity(int contentId, [string tagGroup])
Get a collection of tags by entity id (queries content, media and members), and you can optionally filter by tag group as well
GetTagsForProperty(int contentId, string propertyTypeAlias, [string tagGroup])
Get a collection of tags assigned to a property of an entity (queries content, media and members). Optionally, you can filter by tag group as well
Last updated