` marker, which is how the component knows the post should have a toc. If you uninstall the component, that wrapper stays in the post but has no visible effect.
### Limitations
`h6` headings and headings inside quotes are not included in the toc.
#### Credit
This started as a hard fork of Greg Frankoās [tocify.js](http://gregfranko.com/jquery.tocify.js/) library, and has since been rewritten as native Ember components. There are no external dependencies or requests.
Big thanks to @erlend_sh for lots of valuable feedback and to @david for his help with translations.
> :discourse2: **Hosted by us?** Theme components are available to use on our Pro, Business and Enterprise plans.
> Last edited by @awesomerobot 2026-07-27T16:04:08Z
>
> > **Check document**
> >
> > Perform check on document:
---
### Author:  [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [August 23, 2023, 2:52pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/214 "2023-08-23T14:52:28Z")
4 posts were split to a new topic: [How to move the TOC to the left side of the post?](https://meta.discourse.org/t/how-to-move-the-toc-to-the-left-side-of-the-post/276309)
---
### Author:  [@mentalstring](https://meta.discourse.org/u/mentalstring)
#### Post date: [September 27, 2020, 7:52am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/235 "2020-09-27T07:52:37Z")
I donāt know how this component is implemented or much about the frontend structure of Discourse, so I can only throw in a guess.
> [@tobiaseigen](#):
>
> So displaying both at the same time is a bit unwieldy.
Couldnāt the progress bar only be shown a) if more than 1 post in the topic and b) adjust its start to be from the 2nd post (instead of 3rd), but also c) add some comfortable bottom/top margin to one of the two elements to make sure the other remains distant enough (eg 1vh) as to not make it strange looking?
In other words, instead of using the whole 2nd post as a gap, use CSS to allow some room between them (iff thereās more than 1 post).
Again, this might not make any sense at all as I donāt know much about the way this is working atm.
---
### Author:  [@AndyB](https://meta.discourse.org/u/AndyB)
#### Post date: [May 21, 2021, 2:03pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/269 "2021-05-21T14:03:34Z")
Hi there! We recently installed DiscoTOC for our forums and were wondering if itās possible to get the component to read alt text in images? Weāve used images for some patch note headersā¦
like so:
And unfortunately the TOC system doesnāt seem to be able to parse an image as a header, creating a blank entry on the list and creating a link that takes you to a blank page. Is there any workaround for this beyond ādonāt use imagesā? Thank you! Love the system otherwise.
---
### Author:  [@simon](https://meta.discourse.org/u/simon)
#### Post date: [May 21, 2021, 8:22pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/270 "2021-05-21T20:22:58Z")
> [@AndyB](#):
>
> We recently installed DiscoTOC for our forums and were wondering if itās possible to get the component to read alt text in images?
My guess is that the solution is to not use images as headings, but possibly there will be a way to get it to work by adding some code to your site that hooks into the DiscoTOC code. Whether or not itās worth looking into that will depend on how important it is for you to use images in the postās headings.
---
### Author:  [@AndyB](https://meta.discourse.org/u/AndyB)
#### Post date: [May 23, 2021, 9:14pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/271 "2021-05-23T21:14:21Z")
Weāve been using images as headers in our patch notes consistently for quite some time now, and itās a part of our branding and presentation; not just on the forums, but on Steam and such as well. We would like to have the ability to continue using images as headers while using DiscoTOC in order to remain consistent.
DiscoTOC has been great for other things such as for an AMA recap, a megapost about our dedicated server launcher app, new player guides, etc. We like the system a lot, but would love for a little extra functionality for the way we present patch notes.
---
### Author:  [@TheOctopus](https://meta.discourse.org/u/TheOctopus)
#### Post date: [July 18, 2021, 9:34pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/273 "2021-07-18T21:34:33Z")
The heading anchor functionality on this component slightly conflicts with the _Automatic header links_ functionality [added in 2.7.0beta6](https://meta.discourse.org/t/2-7-0-beta6-automatic-group-avatar-flair-improved-user-education-content-bookmark-pinning-and-more/185908#automatic-header-anchor-links), since headings get two icons on hover, one from Discourse and one from DiscoTOC. Is there a way round this?
---
### Author:  [@Don](https://meta.discourse.org/u/Don)
#### Post date: [July 18, 2021, 9:43pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/274 "2021-07-18T21:43:22Z")
Hello,
You can hide the _Automatic header links_ anchor with
```plaintext
.anchor {
display: none;
}
```
---
### Author:  [@neo](https://meta.discourse.org/u/neo)
#### Post date: [July 21, 2021, 7:41pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/275 "2021-07-21T19:41:46Z")
Hi dodesz,
I made the post width much larger than the default one, and after install this component it looks something wrong, could you tell me how to fix this problem?
ā¤ thanks!
---
### Author:  [@fkohrt](https://meta.discourse.org/u/fkohrt)
#### Post date: [August 27, 2021, 9:11am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/276 "2021-08-27T09:11:04Z")
On a forum running Discourse 2.8.0.beta4 ([90232af778](https://github.com/discourse/discourse/commits/90232af7788f5b9c0d69c47f80c0564275a54060)), including the DiscoTOC component leads to an error message:
The component had been activated before and raised an issue with the previously installed Discourse version as well, although I cannot say which version that was.
---
### Author:  [@simon](https://meta.discourse.org/u/simon)
#### Post date: [August 27, 2021, 4:44pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/277 "2021-08-27T16:44:22Z")
Are you able to find any error messages related to the issue in your siteās error logs?
---
### Author:  [@Falco](https://meta.discourse.org/u/Falco)
#### Post date: [August 27, 2021, 4:50pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/278 "2021-08-27T16:50:23Z")
That error message is a backend error, while DiscoTOC is a front-end theme-component so itās hard for those to be related. Do you have any plugins installed?
---
### Author:  [@fkohrt](https://meta.discourse.org/u/fkohrt)
#### Post date: [August 31, 2021, 6:33am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/279 "2021-08-31T06:33:06Z")
> [@simon](#):
>
> Are you able to find any error messages related to the issue in your siteās error logs?
Unfortunately, I couldnāt find anything useful in the `/logs`.
> [@Falco](#):
>
> Do you have any plugins installed?
I do, hereās the relevant excerpt from `app.yml`:
```yml
hooks:
after_code:
- exec:
cd: $home/plugins
cmd:
- git clone https://github.com/discourse/docker_manager.git
- git clone https://github.com/discourse/discourse-openid-connect.git
- git clone https://github.com/discourse/discourse-checklist.git
- git clone https://github.com/discourse/discourse-push-notifications.git
- git clone https://github.com/discourse/discourse-characters-required.git
- git clone https://github.com/angusmcleod/discourse-news.git
- git clone https://github.com/discourse/discourse-data-explorer.git
- git clone https://github.com/DNOeV/discourse-watch-category.git
- git clone https://github.com/discourse/discourse-footnote.git
- git clone https://github.com/discourse/discourse-knowledge-explorer.git
```
---
### Author:  [@debryc](https://meta.discourse.org/u/debryc)
#### Post date: [September 3, 2021, 8:58pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/280 "2021-09-03T20:58:48Z")
When a header is within a quote, the header doesnāt show up in the TOC. Could this behavior be changed?
> # This header wonāt show up in TOC
>
> Quoted content
# This header DOES show up in TOC
> Quoted content
---
### Author:  [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [September 3, 2021, 9:12pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/281 "2021-09-03T21:12:31Z")
I donāt know how it is planned to work but normally no because itās part of quote, not a heading of that text.
---
### Author:  [@JammyDodger](https://meta.discourse.org/u/JammyDodger)
#### Post date: [September 3, 2021, 9:42pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/282 "2021-09-03T21:42:48Z")
Could you try using the html \
instead? That would allow the header # to be at the start of a line.
Eg:
```plaintext
### Anchor Header
```
> ### Anchor Header
Iāve not tried it in a TOC, but it seems to work with the auto-anchor-headers in a regular post.
---
### Author:  [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [September 4, 2021, 4:18pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/283 "2021-09-04T16:18:05Z")
Why do you want headers within quotes to show up in the TOC? Whatās your use case?
---
### Author:  [@debryc](https://meta.discourse.org/u/debryc)
#### Post date: [September 8, 2021, 9:54pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/284 "2021-09-08T21:54:30Z")
> [@JammyDodger](#):
>
> Could you try using the html
>
> > instead? That would allow the header # to be at the start of a line.
Thank you for the idea. It didnāt work for me, though.
> [@tobiaseigen](#):
>
> Why do you want headers within quotes to show up in the TOC? Whatās your use case?
Hereās an example of when I use quotes to visually structure content starting under Issue Area: Age
> **[A Progressive's Style Guide: Toward Harnessing Language in Support of...](https://hub.youthpowercoalition.org/t/a-progressives-style-guide-toward-harnessing-language-in-support-of-intersectionality-and-cross-sector-power-building/285)**
>
> Caption: Cover art of A Progressiveās Style Guide by Hanna Thomas (SumOfUs.org) and Anna Hirsch (ActivistEditor.com), which shows the faces of people from diverse backgrounds and identities. Downloadable Guide Guide Excerpts Introduction ...
---
### Author:  [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [September 8, 2021, 10:08pm UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/285 "2021-09-08T22:08:33Z")
Why are you using quoting like that? Telling source is enough. Plus grammatically that is wrong, in english too.
---
### Author:  [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [September 20, 2021, 7:36am UTC](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143/287 "2021-09-20T07:36:08Z")
Is this a bug or just another user, butā¦ how should I close the TOC? I was looking for some basic instructions how an enduser should use private messages and of course I went to new users doc and opened the TOC to see if there is some info.
I was using iPad and DiscourseHub.
I got this:
The TOC is just fine. But it is overlapping text and I coudnāt get is suppress back. So what the heck I did wrong, or didnāt at all š„ŗ
[Next page](https://meta.discourse.org/t/discotoc-automatic-table-of-contents/111143.md?page=2)