Knowledge Base Plugin

(Angus McLeod) #1

GitHub-Mark-32px Repository: get the code here

sandbox Example: see it in action here

:heart: Donate: support it here

:man_technologist: Maintainers: @angus


The Knowledge Base plugin allows you to add a knowledge base to your Discourse instance. It works by displaying the first post of every topic in knowledge base categories alongside an orderable, collapsable and responsive nav.

This plugin came out of work with @tobiaseigen on

How to use it

  1. Install the plugin following the steps here.

  2. Give your Knowledge Base a title by updating the knowledge base title site setting, then enable it with the knowledge base enabled site setting.

  3. Nominate a category as a knowledge base category by checking the Knowledge base category setting in a Category’s “General” settings. You can nominate multiple knowledge base categories.

  4. Edit your knowledge base welcome text: Admin > Customize > Text Content “knowledge_base.description”.

  5. Access your knowledge base at or

Discourse as an LMS / Discourse integration with an LMS
Problems with I18n.translations after upgrading to 2.3.0.beta9
(L Jay) #2

Hi Angus,

Managed get this installed and set up, everything looking good, many thanks and now in the process of populating the KB.

I have come up against issues Im not sure I can resolve.

It seems there is a limitation to the amount of (articles) topics per category displayed; you can only add a max of 29 topics.

Any thoughts?

I have looked in the discourse admin/ basic setup and topic limit is set to 50 currently, not sure if that means anything in relation to the topic limit

(Tim Jefferies) #3

This could be a cool way to deliver online courses directly from discourse… :slight_smile:

@angus the example link doesn’t work?


Really like this concept!

Is there a way to reorder how the categories appear in the kb?

(Angus McLeod) #5

I’ve removed this limitation, however I would advise against having many more than 29 topics per knowledge base category at this stage (I’ve yet to add a concept of ‘pagination’ to the list). Try to use more knowledge base categories instead.

Thanks, fixed :sun_with_face:

Yes there is :slight_smile:

You can set a fixed custom order for the knowledge base, which also appears as a new topic list in the relevant knowledge base category in the normal Discourse discovery UI.



I think what you mentioned/screenshot is a way to reorder topics within a category and not the categories themselves? In your picture, suppose in addition to “How to” there was an “Articles” category with a bunch of topics under it - I’m wondering how to set the order of the “How to” and “Articles”.

(Angus McLeod) #7

Ah I see, no not currently, but perhaps there should be!

If someone wants to make a feature request for this please see: How to Request a Plugin Feature

(L Jay) #8

Thanks again Angus,
Will look to getting that updated shortly, cheers for the feedback -i have broken down to category level and shortened, whilst trying to keep the information in context.

One thing i might ask for in feature request is for all the category tabs not to be expanded on opening page (unless via search) on initial KB page ( just a nice to have). Do you think that would be doable?

Its ok found it (cant see for looking)

1 Like

Right now when you click on the > symbol it goes to the category description and when you click on the name of the category itself/anywhere else in the gray box it shows or hides the topics in the category.

I think this is a little counter intuitive and should be the other way around - the > symbol is associated with showing/hiding stuff while I think it’s more expected that clicking on the name goes to the description.

1 Like
(Angus McLeod) #10

Yes, I was thinking the same when I was building this :sweat_smile:. I’ll switch it round:

(David Kingham) #11

This is great Angus. Would it be possible to have embeded videos show up? For example: Video - Learn to use the new forum


Angus I’ve gone to donate half a dozen times to your work over the last year and then remembered you don’t take bitcoin. This plug in solves the lack of permanent stickies (Even if it’s only one on a per category basis) very nicely and will be an absolute god send.

We have a lot of information that people read, take on board at the time but have no use for for anywhere up to 90 days, when they come to look for it they ask staff - a lot. We’re trying to encourage bookmarking but it remains about as popular as celery.

All our revenue for us comes in via crypto and we pay all our bills and other expendables with it as well, for those who are helping out or maintaining plugins it takes 30 seconds to put a receive address on your page/profile. I can’t be the only one here who handles cryptocurrency every day.

(Angus McLeod) #13

This has been updated to be a bit more intuitive:

I’ve made a feature request on your behalf using the feature request wizard on my sandbox.

Which created this feature request topic:

We need 5 votes for this to be added to the open source schedule. See further: How to Request a Plugin Feature

I’ve added a bitcoin wallet address to the donation page :slight_smile:

Interested to hear how use the current feature-set of the plugin with your use case. Let me know how it goes and if there are any issues.

(Andreas Motl) #14

Dear @tobiaseigen and @angus,

thanks for bringing this fine plugin to the general public. We are currently ramping it up on and look forward to its outcome for our little community.

Just a short note: We found that

the latter vanity url at the /knowledge path does not invoke the plugin renderer but yields a 404 Not Found, see

With kind regards,