Table of Contents Documentation

Add the contents list on its own is the automatic placement. Turn it off and headings still get their anchors, but nothing is added to a post unless you place it yourself.

Where in the post offers four positions:

• Before the first heading — the default, and right on nearly every post: after the opening paragraph, above the first section.
• At the very top — above everything, including the introduction.
• After a paragraph you choose — for a post with a long lead-in.
• At the end — for a reference page people arrive at from search and scroll back up through.

Which pages is the same control every Traslatability plugin uses: everywhere, the front page, or only the post types, pages and categories you choose — with exceptions, address patterns, roles and screen sizes on top.

By hand

[toc] anywhere in the content puts the list exactly there. Every setting can be overridden on the spot:

[toc design="rail" numbering="nested" columns="2"]

design, numbering, layout, title, columns, levels, min and collapsible are all accepted, and anything you leave out comes from Settings.

In the block editor, add the Table of contents block. It has the same overrides in the sidebar. The block is rendered when somebody views the page rather than saved into the post, so it can never go stale against a heading you renamed afterwards.

One post at a time

Every post has a Table of contents box in its sidebar with three things in it: always show the list, never show it, or use the settings; a heading just for this post; and headings to leave out on this post only.

That is deliberately all of it. A per-post copy of every setting sounds generous and ages badly — change the design once and a hundred posts keep whatever they were saved with.