# How to create a documentation theme used by discourse

**URL:** https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540
**Category:** Support
**Created:** [July 16, 2024, 12:58pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540 "2024-07-16T12:58:28Z")
**Posts on this page:** 10
**Page:** 1

<div class="post-metadata">

### Author: ![abhijeet\_kumar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abhijeet_kumar/32/432027_2.png) [@abhijeet\_kumar](https://meta.discourse.org/u/abhijeet_kumar)
#### Post date: [July 16, 2024, 12:58pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/1 "2024-07-16T12:58:28Z")

</div>

I could not find a guide to implement the discourse documentation UI as attached screenshot. Can someone help?

 ![documentaion_theme](https://global.discourse-cdn.com/meta/original/4X/c/1/3/c13eadd5290429011a11d43938df0efb18c7d7f5.png)

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [July 16, 2024, 1:01pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/2 "2024-07-16T13:01:36Z")

</div>

I would guess this is really fresh feature and not published yet for us. So there isn’t any documentation.

So, we have to way, unless someone from the team will give us kind of beta state help 😏

---

<div class="post-metadata">

### Author: ![merefield](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/merefield/32/176214_2.png) [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [July 16, 2024, 1:04pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/3 "2024-07-16T13:04:16Z")

</div>

It’s just this, no?:

> [@DiscoTOC - automatic table of contents](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143):
>
> discourse2Summary DiscoTOC will allow you to generate an interactive table of contents for your topics with one click!eyeglassesPreview [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/discotoc)hammer_and_wrenchRepository Link [https://github.com/discourse/DiscoTOC](https://github.com/discourse/DiscoTOC)open_bookNew to Discourse Themes? [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) Install this theme component Samples Desktop Mobile Features toc = table of contents Automatically generates the …

---

<div class="post-metadata">

### Author: ![JammyDodger](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jammydodger/32/254611_2.png) [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [July 16, 2024, 1:08pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/4 "2024-07-16T13:08:25Z")

</div>

The docs sidebar on the left is very new, but you can give feedback and find more about it in this topic:

> [@Better documentation navigation with a new sidebar](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058):
>
> This week, we published a significant improvement to [Discourse documentation](https://meta.discourse.org/c/documentation/10) - a new sidebar! This feature is designed to make navigating and accessing our documentation easier and more intuitive than ever before. star2 What’s new? The new sidebar shows up on all documentation categories and topics, making it easier to navigate their content. Here’s what you can expect: Improved navigation: With a clear, hierarchical structure, moving between different topics is now faster and more straigh…

---

<div class="post-metadata">

### Author: ![abhijeet\_kumar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abhijeet_kumar/32/432027_2.png) [@abhijeet\_kumar](https://meta.discourse.org/u/abhijeet_kumar)
#### Post date: [July 16, 2024, 1:08pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/5 "2024-07-16T13:08:56Z")

</div>

> [@merefield](#):
>
> o?:

TOC is right sidebar, I am looking for left sidebar where you have categories and then topics slug below.  
Check this link:  
[Create a category in Discourse - Documentation / Site Management - Discourse Meta](https://meta.discourse.org/t/create-a-category-in-discourse/197224)

or check click on documentation category of discourse forum

---

<div class="post-metadata">

### Author: ![abhijeet\_kumar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abhijeet_kumar/32/432027_2.png) [@abhijeet\_kumar](https://meta.discourse.org/u/abhijeet_kumar)
#### Post date: [July 16, 2024, 1:22pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/6 "2024-07-16T13:22:14Z")

</div>

Got it..Will it work with docs plugin ? or where can i see it working..as i Cant find it in final UI

---

<div class="post-metadata">

### Author: ![Moin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/moin/32/554653_2.png) [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [July 16, 2024, 1:34pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/7 "2024-07-16T13:34:53Z")

</div>

> [@abhijeet\_kumar](#):
>
> where can i see it working…as i Cant find it in final UI

You can see it working in the #Documentation category here at Meta.  
I don’t think it’s working in combination with the docs view of the docs plugin.

---

<div class="post-metadata">

### Author: ![abhijeet\_kumar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abhijeet_kumar/32/432027_2.png) [@abhijeet\_kumar](https://meta.discourse.org/u/abhijeet_kumar)
#### Post date: [July 16, 2024, 1:36pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/8 "2024-07-16T13:36:05Z")

</div>

Thanks and Got it..We need to add category in settings to see it working. However I did not understand on topic id need to be given..which topic id needs to be provided here…check the screenshot please..

 ![image](https://global.discourse-cdn.com/meta/original/4X/f/9/b/f9bdb1f68b3c45c3b615f02d47cb78dc7c81409a.png)

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [July 16, 2024, 1:37pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/9 "2024-07-16T13:37:24Z")

</div>

This theme component is under active development, and is certain to change significantly in the coming days/weeks. I would not recommend trying to use it anywhere important. Once it’s in a reasonable state, we’ll be creating a topic on Meta with all the info you need.

But if you really want to experiment, you need to create an index topic in each category [like this](https://meta.discourse.org/t/using-discourse-index/308031). It needs to follow the exact header/link structure that we’re using there.

---

<div class="post-metadata">

### Author: ![abhijeet\_kumar](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/abhijeet_kumar/32/432027_2.png) [@abhijeet\_kumar](https://meta.discourse.org/u/abhijeet_kumar)
#### Post date: [July 16, 2024, 5:22pm UTC](https://meta.discourse.org/t/how-to-create-a-documentation-theme-used-by-discourse/316540/10 "2024-07-16T17:22:11Z")

</div>

Thanks @david Got the index page one..I found tally is using it beautifully since 2 months or so..check the screenshot..also they are using nested subcategories as well and index page is two level down ..not sure how to achieve that..I ll give a try..

 ![image](https://global.discourse-cdn.com/meta/original/4X/a/e/5/ae51dae42ce873dafafcf3781ef14d03c3215f22.png)
