Discourse-docs: Documentation Management Plugin

Summary: Find and filter knowledge base topics

:link: GitHub: https://github.com/discourse/discourse-docs
:arrow_right: Install: Follow the plugin installation guide.


The Docs plugin is a continuation of development on the Knowledge Explorer Theme Component. You can see it in action at https://meta.discourse.org/docs.

In essence, Docs allows for easier surfacing of knowledge-base style topics across a defined set of categories and/or tags.

Filter the list down by tags, search via the search bar, and click on topics to see the first post – all without leaving the context of the knowledge explorer.

Need to find a knowledge base topic from somewhere else in Discourse? Use the new search helper: in:kb.


  1. Install the plugin following these instructions.
  2. Enable the plugin by turning on the docs enabled setting.
  3. Add categories and tags to the docs categories and docs tags settings.
  4. Find the Docs link in the hamburger menu.
    Screen Shot 2021-03-01 at 12.49.14 PM
  5. Profit with easier access to knowledge!

Helpful Pairings


  • 2021-01-18T06:00:00Z Rename to discourse-docs
  • 2021-01-13T06:00:00Z Add topic title and category to browser title
  • 2020-10-01T05:00:00Z Added onebox support



It could be possible to hide some tags in homepage of docs?

We are using a category as glossary, so it could be cool to hide letter tags:

And, of course, arrange that tags in that specific category from A to Z:

I think thaat could bee done maybe with CSS, but I don’t know how to do it.

1 Like

Unfortunately with the way the content is structured in the HTML, CSS wouldn’t work for that.

There isn’t a selector that allows you to target elements based on their content.

I’m not aware of another simple way to accomplish this I’m afraid!


How do I get to show the categories on top? (Like meta has too).

Edit: answered my own question. :sweat_smile:

Is seems the discussion history in this topic is automatically deleted, is that on purpose?

1 Like

It is - we move relevant information to the OP of the post to keep these topics from getting outdated and bloated.


When we enable the docs add to top menu setting and click on docs from a category page, it would be GREAT if the docs are then filtered by that category already. Else it takes us out of the category mindset.

Or, is it possible to have docs be added to the top menu only from the main page as opposed to category pages?