Table of Contents: questions and answers

Answers to the questions people ask: 33 of them, free to read before you buy.

  1. Nothing appeared on my postOpen the post in the editor and look at the top of its Table of Contents box.
  2. My post is split into pagesA post split with the Page Break block is shown one page at a time.
  3. My headings are H1s and nothing is listedH1 is switched off by default, and that is usually right: on most themes the only H1 is the post title, so a contents list built from H1s would have one entry — the page you are…
  4. Clicking an entry hides the heading under my sticky headerThat is what Settings → Sticky header is for.
  5. The list is in the wrong place in my postPlacement → Position has four positions.
  6. Some of my headings are inside an accordion or a Details blockThey are listed like any other heading.
  7. I want to leave one heading outIn the block editor, select the heading and switch on Leave out of the table of contents in the Table of Contents panel of its sidebar.
  8. Can I have it in my sidebar?Yes.
  9. The sidebar list is not in the block inserter of my postThat is on purpose.
  10. The floating button or back-to-top button is hidden behind another buttonAnother plugin's button is in the same corner: a chat bubble, say, or the Dark Mode switch.
  11. My floating button says Contents, not the section being readThe floating button can name the section the reader is in, "3 · Choosing a size", changing as they scroll.
  12. Two headings have the same name and the links go to the wrong oneThey should not — identical headings get -2, -3 and so on, so every anchor is unique.
  13. I changed a heading and now an old link is brokenIf Settings → Keep old heading links working is on — it is by default — it should not be.
  14. I used Easy Table of Contents or LuckyWP. Do I have to edit my posts?No.
  15. Does it work with page builders?If the builder outputs real heading tags into the post content, yes — the plugin reads the rendered content, so a heading produced by a shortcode or a block is found like any…
  16. Does it slow the page down?One small stylesheet and one small script, both from your own server, sent minified, and only on pages that show a contents list.
  17. I changed a setting and my posts still show the old listThe list is part of each cached page, so saving a change on the plugin's screens asks your page cache to empty, and so does switching the plugin off: NimbleCache, WP Rocket…
  18. Will it work without JavaScript?Yes.
  19. Does it store anything about my readers?No.
  20. Will it help my search rankings?Not by itself — no plugin does that.
  21. How do I change the wording of the heading?Table of Contents takes the words above every list from Design → Heading, so type your own there and save; left empty, the heading reads “Contents”.
  22. My theme is dark and the list looks wrongPick a design that suits it.
  23. Can I put the numbers back to plain 1. 2. 3.?Design → Numbering.
  24. The list is enormous on my reference pageThree things, in the order worth trying: Design → Compact — small type packed tight, built for exactly this. Design → Layout: flat and set Columns to 2 or 3. Settings → Show a…
  25. It prints as an empty boxThat was a bug in the sense that a folded list used to print folded.
  26. Does an expired licence stop the plugin?No.
  27. Removing the pluginDeactivating leaves your settings and every anchor alone.
  28. Why does the page not reload when I save?Because it does not need to.
  29. The confirmation message disappears too quicklyHover it and it stays.
  30. I have used all my activations. Which sites are they?The plugin's Licence screen lists them.
  31. What happens to a site I free?Its copy of the plugin keeps working exactly as it is.
  32. The licence screen says "Not activated on this site"Your key is fine — this site simply is not one of the sites using it.
  33. Can I copy my setup to another site?Yes.

Still stuck? Ask the developers who wrote it. We aim to reply within one business day.