On this page, we have listed the most common issues and how to resolve them.
The inline Table of Contents is not showing
- Check the Minimal headings count (under General > Table of Contents) option value. By default it is set to 3 and the TOC will not show if there are less than 3 headings on the page. Set to 0 to show always.
- Make sure the Hide main table of contents (under General > Table of Contents) option is switched off.
Options or not applying correctly
- If you are using the Block, open the block settings, and check for any setting override (marked with a red star *)
- If you are using the Shortcode, make sure you did not use a custom attribute that could override the Global settings.
- If you are using Post type settings, make sure you are saving the relevant Post type settings (it will show next to the Save button which settings you are currently editing)
The Floating TOC is not showing or is partially hidden
- If your site has a fixed header, the floating TOC could be hidden behind it. Adjust the Floating vertical offset to push the floating TOC down.
- Try activating the Compatibility mode (under Floating TOC > Floating Table of contents)
- Increase the z-index value of the floating TOC by adding (see how below)
To increase the z-index value of the Floating TOC, add this custom CSS under Styles > Custom CSS and increase the value if needed.
:root{
--jtoc-floating-toc-z-index: 10000;
}
One or many colors from the palette are not applying
- Check for any overrides under the Styles tab. For example, you set the Background color in the palette to Red (color #1) and you expect the background color to be red. But at the same time, you also set the Table of contents Background color (under Styles > Table of contents) to Blue. The value from the Styles tab has a higher priority and overrides the palette. Unset this color or change it accordingly.
Some headings are missing
- Make sure your heading is covered by the selected Headings depth (under Headings > Headings processing). If your missing is of type H4, you need to have the H4 type checked (in blue)
- If using the Block, check for any override in the Block settings.
- Make sure your article is correctly structured (from H2 to H6). Basically the first heading should be of type H2.
The heading structure looks awkward
- Make sure your article is correctly structured (from H2 to H6) and does not skip levels. For example, if a heading is of type H2, its direct child should be of type H3 (not H4 or H5).
The table of contents shows unwanted bullets or spacing
Your theme may override the ol / li list CSS styles generated by the TOC (despite being highly specific by default).
To get around this, you may need to add custom CSS rules (under Styles > Custom CSS) with either a higher CSS specificity or by leveraging the !important tag.