A comprehensive guide to Discourse tags

If you haven’t read it already, It’s Time We Talked About Tags provides an overview of how tags can be used as an organizational tool.

Enabling and Configuring Tags

Tag settings can be found in your admin panel under the “Tags” section of your site settings.

Tagging is not enabled by default. To enable tags, ensure that the tagging_enabled setting is checked.

Creating and applying tags

Tags are created upon first usage. When composing or editing a topic, a user with tag creation and/or application privileges will see a tag chooser next to the category chooser.


Tags can also be adjusted when quick editing a topic title:

:mega: Please note that categories, depending on their settings, can optionally limit which tags may apply to that category.

Filter topics by tags

You can find the full list of tags on the tags page on your site, along with a count of how often each tag has been used. Selecting a tag will present a list of topics that have had the tag applied.

:mega: If you ever need to filter topics by more than one tag at the same time, use the following URL syntax:


Rename or delete a tag

  1. Go to the tags page on your site.
  2. Select the tag you wish to rename or delete.
  3. Select the rename button to rename the tag or the trash button to delete it.

Append or replace tags

  1. Visit any topic list
  2. Select the bulk button at the top left of the topic list to enable bulk selection.
  3. Manually select topics or use the “Select All” option.
  4. Once you have a selection, use the wrench button that appears to right of the topic list.
  5. Select the “Replace Tags” option and replace all existing tags on the selected topics with the tag or tags you specify, or use the “Append Tags” option to add tags, keeping any existing tags in place.

Tag admin options (Manage tag groups, upload tags, and delete unused tags)

Go to the tags page on your site and look for the tag admin button to the upper-right of the page:


:mega: For more information on tag groups see Tags: category restrictions, tag groups, relationships.

Related Topics

How do I set tag tracking level defaults historically
Tag icons component


Some of this howto should be translated, don’t you think? It’s important for the beginners to have this knowledge and, we all know, there are lots of people who doesn’t understand english yet, at least at Spain! (Where I come from).

I’ve been looking for translation but, or I didn’t see it, or there’s not option other than translate the platform, Discourse I want to mean.

Are you, any of you at Discourse Community, moving resources to make possible this option? Or no one has thought about it? I would like to help, if there’s something similar ongoing…


It is probably a better use of your time to look at improving the translations in the Discourse UI for your desired language, first. We do that on transifex Discourse localization


Well, maybe you’re right but my question is, isn’t it a good idea to translate the howto themes too, so the beginners can understand better the way Discourse works?

Just a quick question (I don’t seem to have tags “privileges” yet): Are tags “per topic” ? (only controlled by the initial poster and staff after that, then ?) or “per post” ? (any person replying can put the tags they want on their own message). I suspect tags are only on the “topic” level, but just want to make sure.

1 Like

That’s correct, topic-level only.