Hi Atlassian Community,
My name is Tiffany Chung, and I’m a Product Manager on the Confluence Cloud team.
The Table of Contents macro is a highly used feature that creates a table of contents for a page based on its headings. This helps readers find their way around lengthy pages, summarizing the content structure and providing links to headings.
Previously, the right rail of the Table of Contents macro was cluttered and heavy-handed. It showcased all possible fields which made it difficult to easily navigate and configure your table of contents. Moreover, some fields allowed users to enter any value when there were limited valid values. For ex. you could specify any value for the heading levels when only inputs 1-7 were valid.
The new and improved Table of Contents macro enables you to customize your table of contents through a basic and advanced tab. The basic tab allows you to quickly and simply configure the look of your table of contents through dropdowns and checkboxes, while the advanced tab allows you to further customize your table of contents with more technical and less commonly used fields, such as headings include and exclude.
Today:
In the basic tab, you can quickly configure your list style, bullet or separator type, heading levels and whether to include section numbering.
For more granular customization of your ToC, you can click into the advanced tab and set your heading indent and ToC style with a CSS class name, include or exclude certain headings and whether to include your ToC in exported PDFs.
Insert a Table of Contents macro by selecting it from the toolbar or typing “/tableofcontents” in the body of your page.
To configure, select the pencil icon in the toolbar and configure using either the basic and/or advanced tabs. Any changes made are autosaved.
Publish your page to see your table of contents.
For more information about the Table of Contents macro or fields, visit the documentation page.
Don’t forget to let us know any feedback or questions you have in the comments. We’d love to hear your suggestions on how we can make this experience even better for you! If you don't see the experience today, you'll see it coming to you instance very soon.
Tiffany Chung
14 comments