# DiscoTOC - automatic table of contents
**URL:** https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143
**Category:** Theme component
**Tags:** official, disco-toc
**Created:** [9 maart 2019 om 05:36 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143 "2019-03-09T05:36:22Z")
**Posts on this page:** 20
**Page:** 5
### Author:  [@topological](https://meta.discourse.org/u/topological)
#### Post date: [8 april 2022 om 07:10 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/354 "2022-04-08T07:10:27Z")
I am using DiscoTOC for a long time, and it works fine with Chinese headings until recent update.
If there are multiple Chinese headings (including no ascii characters) in the post, it will only navigate to the first heading of one level when the navigation item on the right side is clicked. I believe this is because the DiscoTOC generates navigation items with the same id (because the headings are all in Chinese). So, the query selector will only find the first heading.
As a try, I forked the GitHub repo and pushed a little commit as
[https://github.com/ShuiyuanSJTU/DiscoTOC/commit/54b12e937718fe7cb4156cba202f1adb2597edf3](https://github.com/ShuiyuanSJTU/DiscoTOC/commit/54b12e937718fe7cb4156cba202f1adb2597edf3)
It seems to work in my site. If it looks good to you team, I can raise a pull request, or this bug need to be fixed in another way.
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [1 mei 2022 om 20:34 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/355 "2022-05-01T20:34:18Z")
Thanks @topological š Iāve moved your bug report over to the DisoTOC topic itself to hopefully get it in front of the right people. š
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [5 mei 2022 om 18:33 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/356 "2022-05-05T18:33:54Z")
Thanks for the report and the PR. As noted in the PR, I have implemented a [different fix](https://github.com/discourse/DiscoTOC/pull/36), that doesnāt rely on headings having anchors as children.
(Iām happy to merge the translations in your PR, though.)
---
### Author:  [@Awesome\_E](https://meta.discourse.org/u/Awesome_E)
#### Post date: [7 mei 2022 om 05:35 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/357 "2022-05-07T05:35:31Z")
First off, this is a super helpful theme component for long posts!
However, thereās an issue with this theme component on mobile devices (at least on iOS). When I open a large table of contents, scrolling through the TOC doesnāt work on mobile like it does on a desktop.
The list contains Headings A-H, but I canāt scroll through it
The list appears to be scrollable, but a touchstart event prevents the list from being scrolled. Disabling the touch start event listener for the `d-toc` element seems to solve the issue.
* * *
I canāt see the version of the theme component we have on our forum, nor can I test this on a local install (since I canāt load it on a phone). So, if there is a fix Iām not aware of or if thereās anything I should, please let me know.
Thanks in advance š
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [7 mei 2022 om 21:55 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/358 "2022-05-07T21:55:25Z")
Thanks for the report, the screenshots were particularly helpful in tracking down the issue. This is a problem that comes from core, one of the parent elements of the DiscoTOC mobile UI disables scrolling of its children, and this affected DiscoTOC. Should be fixed via [FIX: Limit pan event handler to fix scrolling in TOC by pmusaraj Ā· Pull Request #16673 Ā· discourse/discourse Ā· GitHub](https://github.com/discourse/discourse/pull/16673) (itāll likely be merged early next week).
---
### Author:  [@jerry0](https://meta.discourse.org/u/jerry0)
#### Post date: [8 mei 2022 om 13:03 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/359 "2022-05-08T13:03:47Z")
> [@simonk](#):
>
> After a full rebuild, I can confirm that the ToC appears correctly on the discourse-docs page - thanks a lot
Is this still working?
@pmusaraj I guess itās possible that I havenāt set this correctly but I have installed the theme and the TOC I set up on a topic is not appearing on the discourse-docs version but it is appearing in the main topic
---
### Author:  [@simonk](https://meta.discourse.org/u/simonk)
#### Post date: [9 mei 2022 om 08:51 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/360 "2022-05-09T08:51:46Z")
Hmm, I agree, the ToC seems not to be appearing in discourse-docs pages again. For example:
[https://meta.discourse.org/docs?ascending=false&category=53&tags=themes&topic=91966](https://meta.discourse.org/docs?ascending=false&category=53&tags=themes&topic=91966)
---
### Author:  [@pmusaraj](https://meta.discourse.org/u/pmusaraj)
#### Post date: [9 mei 2022 om 19:06 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/361 "2022-05-09T19:06:58Z")
The mobile scrolling issue fix is now merged. I also added a compatibility fix for the discourse Docs view, you can see it in action [here on meta](https://meta.discourse.org/docs?topic=93648).
---
### Author:  [@mksafi](https://meta.discourse.org/u/mksafi)
#### Post date: [19 mei 2022 om 16:15 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/364 "2022-05-19T16:15:26Z")
If you prefer to have the table of content always fully expanded, try adding this CSS to your theme
```css
#d-toc li.d-toc-item > ul {
max-height: 500em !important;
overflow: visible !important;
opacity: 1 !important;
}
```
---
### Author:  [@Awesome\_E](https://meta.discourse.org/u/Awesome_E)
#### Post date: [23 mei 2022 om 21:48 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/367 "2022-05-23T21:48:34Z")
Can confirm thatās been fixed as well š
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [16 oktober 2023 om 07:37 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/368 "2023-10-16T07:37:46Z")
5 posts were split to a new topic: [When ToC present, I lose access to the topic wrench?](https://meta.discourse.org/t/when-toc-present-i-lose-access-to-the-topic-wrench/282327)
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [11 december 2023 om 17:54 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/421 "2023-12-11T17:54:54Z")
The next time you update DiscoTOC youāll probably notice that weāve added a button to toggle between the topic timeline and the table of contentsā¦ let us know if you encounter any issues or have feedback about this new feature!
---
### Author:  [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [11 december 2023 om 17:57 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/422 "2023-12-11T17:57:59Z")
I love it! š»
Did just have to refresh my browser to see it in this topic, because itās that shiny and new! š
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [26 maart 2024 om 13:49 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/432 "2024-03-26T13:49:05Z")
Iāve just made a minor update to this theme that ignores the trust level requirement for staff accounts, this more closely follows how Discourseās settings behave.
---
### Author:  [@fbpbdmin](https://meta.discourse.org/u/fbpbdmin)
#### Post date: [7 mei 2024 om 21:21 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/433 "2024-05-07T21:21:31Z")
this component works nicely for the first post, thanks for this nice oneā¦
wonder if possible to do the autoTOC for the posts below as wellā¦ that seems a common case when try to document something using one post and comments belowā¦
say, when browsing to the main post or replies below, if the post/reply has titles/subtitles defined, it auto shows its TOC, otherwise shows the default timeline thingā¦
I did not read this long thread, did a quick search, seems not discussedā¦
thanksā¦
---
### Author:  [@Moin](https://meta.discourse.org/u/Moin)
#### Post date: [7 mei 2024 om 21:35 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/434 "2024-05-07T21:35:15Z")
> [@Disco TOC for replies](https://meta.discourse.org/t/disco-toc-for-replies/217885/5):
>
> Update: The changes in this fork have been merged upstream, please use the official theme components instead For anyone who wants to apply DiscoTOC in their replies, I did this part of the work in my own fork! Now it can apply TOC to any post and it works fine, just like it does on the OP. It seems that the official team doesnāt think itās necessary to apply DiscoTOC in the replies, so I wonāt open a pull request. But you can use my modified version! [https://github.com/Lhcfl/DiscoTOC-ediā¦](https://github.com/Lhcfl/DiscoTOC-edited)
---
### Author:  [@fbpbdmin](https://meta.discourse.org/u/fbpbdmin)
#### Post date: [7 mei 2024 om 22:01 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/436 "2024-05-07T22:01:06Z")
another question
somehow, I donāt see the button to switch between content and TOC
the same using the official disco-toc or @Moin 's forked versionā¦
is there a setting for this? seems notā¦ hmmā¦
my system is on discourse 3.2.1
someone could give a hint? thanksā¦
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [7 mei 2024 om 22:28 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/437 "2024-05-07T22:28:55Z")
> [@fbpbdmin](#):
>
> my system is on discourse 3.2.1
you need to update Discourse, the feature required some Discourse updates
---
### Author:  [@fbpbdmin](https://meta.discourse.org/u/fbpbdmin)
#### Post date: [7 mei 2024 om 22:30 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/438 "2024-05-07T22:30:09Z")
> [@awesomerobot](#):
>
> you need to update Discourse
hmm, seems 3.2.1 is the current release, right ?
update to beta ?
---
### Author:  [@awesomerobot](https://meta.discourse.org/u/awesomerobot)
#### Post date: [8 mei 2024 om 13:57 UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/439 "2024-05-08T13:57:16Z")
Yes, major versions have a much slower release schedule, so you may be waiting months for new features and security updates otherwise ā by default we recommend staying up to date with our beta releases. Some more info here: [Understanding Discourse release channels](https://meta.discourse.org/t/why-does-discourse-always-install-beta-versions-by-default/264400)
[Previous page](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=4)
[Next page](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=6)