# Discourse Doc Categories

**URL:** https://meta.discourse.org/t/discourse-doc-categories/322376
**Category:** Plugin
**Tags:** official, doc-categories
**Created:** [August 26, 2024, 11:00pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376 "2024-08-26T23:00:13Z")
**Posts on this page:** 20
**Page:** 2

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [September 6, 2024, 3:13am UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/26 "2024-09-06T03:13:02Z")

</div>

You don’t need to point the Docs plugin to the category - this plugin replaces the Docs plugin. That might be what is affecting things for you, as it would cause a conflict with one overriding the other.

All you need to do is make sure `doc categories enabled` is checked, and then create the index topic in the category, adding it to the category’s settings in the Index topic field. If you still have the category set in the old Docs plugin settings, then you should remove it from there.

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 6:39pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/27 "2024-09-06T18:39:44Z")

</div>

Hey Hugh, thanks for the swift reply! If I said the Docs plugins, my apologies. I only have the Doc Categories plugin installed here.

So here is the useful report to find Topics not indexed. I only have 2 test topics so far.

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

Then here is the settings screen. I know I am close, but I’m missing a step or 2 somewhere! Thx!

 ![image](https://global.discourse-cdn.com/meta/original/4X/4/d/1/4d10e8b8839135542f81880c336ba5175859103f.png)

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [September 6, 2024, 6:41pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/28 "2024-09-06T18:41:59Z")

</div>

Did you set the category setting?

Also, what does your index look like? Is it structured [like-so](https://meta.discourse.org/t/using-discourse-index/308031)?

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 7:20pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/29 "2024-09-06T19:20:36Z")

</div>

Hi Marc! Yeah Category is set (obviously) set via the report above right? but here it is.

 ![image](https://global.discourse-cdn.com/meta/original/4X/8/1/f/81f996750945cfddb90988482bd8780b38171c95.png)

Category page looks like this:

 ![image](https://global.discourse-cdn.com/meta/original/4X/8/6/0/860866725091da3e4dde36ad5486a1a9592e719b.png)

I know i’m missing something. What did you mean by this page: Is it structured [like-so](https://meta.discourse.org/t/using-discourse-index/308031)?

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [September 6, 2024, 7:22pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/30 "2024-09-06T19:22:30Z")

</div>

> [@dennisjbr](#):
>
> What did you mean by this page: Is it structured [like-so](https://meta.discourse.org/t/using-discourse-index/308031)?

This links to a index for the #Documentation on Meta. Your designated topic needs to look similar to that for the index to generate. From ur screenshots, I think you misunderstood/misread something. Read from [here](https://meta.discourse.org/t/discourse-doc-categories/322376#p-1584993-index-topics-3).

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 7:23pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/31 "2024-09-06T19:23:03Z")

</div>

Also, kind of off-topic – but maybe night. Do I need the sidebar theme plugin to show index on the right as well? or is that automatic as well? Thanks!

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [September 6, 2024, 7:23pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/32 "2024-09-06T19:23:57Z")

</div>

Not sure what you mean, from my understanding the sidebar is default/core and not a plugin.

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 7:27pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/33 "2024-09-06T19:27:15Z")

</div>

Gotcha, did you mean by the heading/subheading sections? I was looking for that in the composeer, but it wasnt apparent (to me anyway) if i needed like HTML \< h1 \> headings and what not. Appreciate again the rapid responses!

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [September 6, 2024, 7:29pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/34 "2024-09-06T19:29:02Z")

</div>

Headings are h1, links are by bulletpoints. You can literally copy paste the meta index it should give you an example to start with if you’re struggling.

---

<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: [September 6, 2024, 7:33pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/35 "2024-09-06T19:33:38Z")

</div>

Like this way:

```plaintext
## something useful
* this is that: https://forum.example.tld/t/777
* that is another: https://forum.example.tld/t/666

```

Etc

I’m lazy so I didn’t do that manually, but I used AI of forum.

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 7:55pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/36 "2024-09-06T19:55:13Z")

</div>

Thanks. So i copied a part of the Documentation index above as provided by @MarcP, just don’t see the sidebar index which is strange, unless again im missing something…

 ![image](https://global.discourse-cdn.com/meta/original/4X/2/8/a/28a73906a623ffb048467091ef1dc6f0e6254576.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: [September 6, 2024, 8:00pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/37 "2024-09-06T20:00:25Z")

</div>

That screenshot doesn’t show the structure. Are you totally sure you are using form

`* description: url`

and you tell name, url or ID of that topic in settings of that category?

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 8:05pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/38 "2024-09-06T20:05:20Z")

</div>

Like this?

 ![image](https://global.discourse-cdn.com/meta/original/4X/a/8/e/a8e0e64aaa688e9e1c2d1551bda71070c668cdcb.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: [September 6, 2024, 8:12pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/39 "2024-09-06T20:12:07Z")

</div>

Yeah. If you see something similar to this in composer (don’t mind the really strange language, the idea should be clear though):

```plaintext
Tätä käytetään hampurilaisvalikossa esittelemään 20 eniten reaktioita saanutta ketjua kategoriassa #koiramaailma . Eräänlainen mainosikkuna siis.

## Top-20 eniten reagoitua ketjua

* Mitä helvettiä eläinlääkinnässä tapahtuu 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Kuivamuonamainokset: Hassut aidot tapaukset: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

```

Those descriptions don’t show on the sidebar.

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 8:16pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/40 "2024-09-06T20:16:40Z")

</div>

Well, as you can see, nothing on the right side ☹

If it helps anyone, here is the list of plugins i have installed as well…

```
    cmd:
      - git clone https://github.com/discourse/docker_manager.git
      - git clone https://github.com/discourse/discourse-solved.git
      - git clone https://github.com/discourse/discourse-user-notes.git
      - git clone https://github.com/discourse/discourse-openid-connect.git
      - git clone https://github.com/discourse/discourse-ai.git
      - git clone https://github.com/discourse/discourse-yearly-review.git
      - git clone https://github.com/paviliondev/discourse-custom-wizard.git
      - git clone https://github.com/discourse/discourse-doc-categories.git
      - git clone https://github.com/discourse/discourse-reactions.git
      - git clone https://github.com/discourse/discourse-akismet.git
      - git clone https://github.com/discourse/discourse-data-explorer.git
      - git clone https://github.com/discourse/discourse-oauth2-basic.git
      - git clone https://github.com/discourse/discourse-assign.git
      - git clone https://github.com/discourse/discourse-templates.git
      - git clone https://github.com/discourse/discourse-policy.git
      - git clone https://github.com/discourse/discourse-gamification.git
      - git clone https://github.com/discourse/discourse-category-experts.git
      - git clone https://github.com/merefield/discourse-ai-topic-summary.git
      - git clone https://github.com/MonDiscourse/discourse-formatting-toolbar.git
      - git clone https://github.com/discourse/discourse-custom-topic-lists.git
      - git clone https://github.com/thoka/discourse-send-pdf-inline.git
      - git clone https://github.com/discourse/discourse-prometheus.git
      - git clone https://github.com/communiteq/discourse-user-response-times.git
      - git clone https://github.com/discourse/discourse-fingerprint.git
      - git clone https://github.com/discourse/discourse-bcc.git
      - git clone https://github.com/featheredtoast/discourse-pushover-notifications.git
      - git clone https://github.com/discourse/discourse-saved-searches.git

```

---

<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: [September 6, 2024, 8:22pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/41 "2024-09-06T20:22:09Z")

</div>

> [@dennisjbr](#):
>
> Well, as you can see, nothing on the right side

Usually the sidebar is on the left (red) The docs sidebar just replaces the default content. On the right (purple) you see a table of content which is added by the [DiscoTOC - automatic table of contents](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143) thrme component.

 ![Screenshot_20240906_222045_Gallery](https://global.discourse-cdn.com/meta/original/4X/3/9/6/396356952c5d5331104322bae731b73f5b6e6e80.jpeg)

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 8:26pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/42 "2024-09-06T20:26:03Z")

</div>

Yeah DiscoTOC is an installed theme component as well. Can’t get that going either. Something is amiss…

---

<div class="post-metadata">

### Author: ![MarcP](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/marcp/32/160184_2.png) [@MarcP](https://meta.discourse.org/u/MarcP)
#### Post date: [September 6, 2024, 10:07pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/43 "2024-09-06T22:07:54Z")

</div>

Not sure but your screenshots are not clear. You are taking the screenshot and not showing a sidebar at all? It’s the doc sidebar not showing? Or is the sidebar not showing at all (is it not just hidden, try pressing =)

Edit; thinking of this you should be clear if you are having issues with discoTOC (table of content for the OP) or the doc-categories (doc index sidebar)

---

<div class="post-metadata">

### Author: ![dennisjbr](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dennisjbr/32/444916_2.png) [@dennisjbr](https://meta.discourse.org/u/dennisjbr)
#### Post date: [September 6, 2024, 10:53pm UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/44 "2024-09-06T22:53:25Z")

</div>

Hey Marc–  
So the DiscoTOC works. I went back double-check and it does indeed create a sidebar TOC after I go to gears and insert TOC as instructions say.

All of my screenshots include the sidebar, so i am showing the open landscape w/o any sidebars showing.

I just have this weird feeling it will be a very simple fix, but I’m not there yet ☹

---

<div class="post-metadata">

### Author: ![hugh](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/hugh/32/336717_2.png) [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [September 7, 2024, 9:38am UTC](https://meta.discourse.org/t/discourse-doc-categories/322376/45 "2024-09-07T09:38:45Z")

</div>

> [@dennisjbr](#):
>
> All of my screenshots include the sidebar, so i am showing the open landscape w/o any sidebars showing.

I don’t see any sidebars in your screenshots - they all show just the post content. Could you post a screenshot of the full Discourse screen when you’re on a category that should have an index showing?

[Previous page](https://meta.discourse.org/t/discourse-doc-categories/322376.md?page=1)

[Next page](https://meta.discourse.org/t/discourse-doc-categories/322376.md?page=3)
