NewThe Supreme Bundle: every Divi Supreme plugin, 31% less than buying separately.See what’s inside →

Table Of Contents module

Divi Table Of Contents that builds itself.

Table Of Contents for Divi 5. It reads your headings, links to each one and highlights the section being read.

Guide · Launching a Divi site

Plan the pages

List every page the site needs and what each one has to do before you open the builder.

Map the sitemap

Group pages into a simple sitemap so the menu and internal links follow from it.

Write the content first

Draft real copy for the main pages. Layouts built around real text need fewer fixes later.

Design the theme

Set up the look once in Divi 5 so every page shares it.

Set global colours

Save brand colours as global colours, then use them everywhere instead of hex codes.

Check contrast

Check text against its background. Body text needs a contrast ratio of at least 4.5:1.

Pick the type scale

Choose two fonts at most and a clear size scale for headings and body text.

Build and test

Build the pages from your saved layouts and test them on real devices.

This part starts with an empty heading, which Skip empty headings leaves out.

Test page speed

Run a speed test on the heaviest page and compress any large images.

Launch

Point the domain, turn on caching and submit the sitemap to search engines.

Related reading

This box has the class .dsm-toc-ignore, so the Ignore selector can leave it out.

What is the Divi Table Of Contents module?

Table Of Contents is a Divi 5 module in Divi Supreme Pro that builds a clickable list of the headings on a page. Use it on blog posts, long guides, documentation, course lessons and legal pages.

Drop it in a post template and it finds the main content area by itself, or point it at a CSS selector. Choose the heading levels, skip regions like related posts, and pick a bulleted or numbered list. It scrolls smoothly to each heading, respects a fixed header offset, highlights the section in view and can fold behind a toggle on mobile.

default heading levels

list styles

anchor IDs to add by hand

mobile toggle

Start from a Table Of Contents recipe.

The recipes and the playground run on the front end. Use Preview, or open the page, to try them.

Try every Table Of Contents setting.

The recipes and the playground run on the front end. Use Preview, or open the page, to try them.

Everything Table Of Contents can do.

Finds the content

Detects the main post area by itself, or use any Content wrapper CSS selector.

Your heading levels

Heading selectors such as h2, h3, h4 decide what goes into the list.

Ignore regions

Leave out headings in sidebars or related posts with the Ignore selector.

Active section

The link for the section in view is highlighted as visitors scroll.

Smooth scroll and offset

Glide to each heading and stop below a fixed header with Scroll offset.

Numbered or bulleted

Turn on Numbered list for docs and step-by-step guides.

Collapse inactive

Only the branch of the section in view stays open.

Mobile toggle

On small screens the list folds behind a button with your own label and icon.

Table Of Contents documentation

Step-by-step guide to content selectors, heading levels, scroll offset and the mobile toggle.

Questions about Table Of Contents.

How do I add a table of contents to Divi blog posts?

Add the Table Of Contents module to your post or post template. Leave Content wrapper CSS selector empty and it detects the main post area (.et-db regions, article, main, #main-content) and lists its h2, h3 and h4 headings.

How do I choose which headings appear?

Edit Heading selectors as a comma-separated list, for example h2, h3. The default is h2, h3, h4.

How do I stop headings from hiding under a sticky header?

Set Scroll offset to the height of your fixed header. Clicked headings then stop that far below the top of the screen. The default is 0px, and Smooth scroll on click is on by default.

Can I leave out headings from sidebars or related posts?

Yes. Add their CSS selectors to Ignore selector, for example .dsm-toc-ignore. Skip empty headings, on by default, also leaves out headings with no text.

Does it highlight the section being read?

Yes. The link for the section in view gets the active state, which you style under Lists, Is active in the Design tab. Turn on Collapse inactive to only expand the branch of that section.

How do I make it collapsible on phones?

Turn on Collapsible on mobile, then set the Mobile toggle label (default "Contents"), Mobile toggle icon and Mobile toggle icon placement (Left or Right).

What shows when a page has no headings?

The text in Message when no headings found. By default it reads "No headings were found in the selected content area."

Can I translate it with WPML?

Yes. The content wrapper selector, heading selectors, mobile toggle label and no headings message are registered for WPML.

Next module, A to Z

Testimonials Module

Related modules

Read More Module

Fold long text behind a button.

Post Reading Time Module

Estimated minutes to read.

Table Module

Data and pricing tables.

4.9 out of 5

Rated 4.9 by Divi designers on Trustpilot. Running on 350,000+ sites.

Help readers find their place.

Table Of Contents comes with 70+ Divi 5 modules and 16 extensions in Divi Supreme Pro.

Divi Supreme