Divi Table Of Contents Maker

Documentation & Support

Still Need Help?

If you have a question not covered here in the docs, or if you face any technical issue, you can reach out to us.

Visit Our Support Page

Divi Table of Contents Maker Plugin by Pee Aye Creative

Ready To Download?

Visit the product page to get all the details and download the plugin.

View Product

five star rating_1

Are You Enjoying Divi Table Of Contents Maker?

If you are enjoying the Divi Table Of Contents Maker plugin, we would really appreciate it if you could share a public review! ❤️

It is such a blessing to hear your feedback, and reviews help other Divi users make informed decisions about the value of our products.

Leave A Review

Troubleshooting and Frequently Asked Questions for the Divi Table of Contents Maker plugin by Pee Aye Creative

Troubleshooting & FAQs

Solutions to common issues and frequently asked questions to help you troubleshoot any problems you may encounter.

Troubleshooting

If you are facing a technical issue with the Divi Table Of Contents Maker, please check the troubleshooting steps listed below. If the outcome of following the steps below points to an issue with our plugin specifically, please send us a support message. When you reach out for support, we will ask about the results of these troubleshooting steps to better understand and resolve the issue.

👉 General Troubleshooting Steps

Step 1: Deactivate All Plugins Except Divi Table Of Contents Maker

When troubleshooting an issue with our plugin, it’s essential to determine whether there is a conflict with another plugin. To do this, please deactivate all other plugins on your site, leaving only the Divi Table Of Contents Maker active. If deactivating the other plugins resolves the issue, it indicates a conflict with one of them.

To identify which plugin is causing the conflict, start by reactivating each plugin one at a time. After reactivating each plugin, refresh the page to check if the issue still happens. Continue this process until you find the plugin that triggers the problem.

Once you’ve identified the conflicting plugin, please let us know the details so we can provide further assistance.

If the issue is still happening with only our plugin active, it suggests the problem may not be related to a conflict and will require further investigation.

Step 2: Deactivate Our Divi Table Of Contents Maker Plugin

Please temporarily deactivate the Divi Table Of Contents Maker to confirm whether our plugin is causing the issue. While this may seem counterintuitive, it is an important step to verify if the problem is related to our plugin.

If the issue persists after deactivating our plugin, it suggests that our plugin is not the cause. Conversely, if the problem only occurs when our plugin is active, it indicates that our plugin might be involved and will require further investigation.

🔧 Common Issues

Below is a list of common issues you may encounter when using this plugin. Please review the solutions or explanations provided for any issues that are relevant to your situation.

The Module Is Not Showing Using Theme Builder

Divi table of contents maker not showing clear Divi cache

If you still experience the issue, try logging out and back in, as this can trigger the cache clearing.

If the clear cache button in Theme Options does not work, please open the page settings in the Theme Builder template, go to the Advanced tab, open the Performance toggle, and disable the Static CSS File Generation setting.

Divi table of contents maker not showing clear Divi static css cache in theme builder template

You may also need to clear other cache from plugins, hosting server, or CDN. You can learn more about clearing cache in our tutorial about How To Clear Cache In Divi.

NOTE for WP Engine Customers: The hosting company WP Engine has a lot of proprietary systems that are intended to help users, but sometimes end up as a hassle. A customer had this issue with the module not showing and after several days of troubleshooting they heard back from their hosting company support and the issue was caused by their own Object Caching. They gave the customer instructions on how to clear it, but you will need to reach out to WP Engine support about that.

NOTE for NitroPack Customers: Another customer could not get their TOC to show, and it was caused by NitroPack, so be sure to check that.

Links Not Scrolling When Clicked

If the table of contents links are not scrolling to the correct headings, the issue might be related to the HTML structure within the heading tags. Our plugin relies on clean heading tags to generate the links and ensure they scroll properly. If there are additional HTML elements, such as spans or other tags, within your heading tags, it can disrupt the ID assignment and prevent the links from functioning as expected.

To fix this, review your headings and remove any extra HTML tags inside the heading tags. Keeping the heading tags clean will help the links scroll correctly to the corresponding sections.

Code Showing In Blog Module Excerpt

If you see code appearing in the Blog module excerpt area while using our Table of Contents module, don’t worry—this is completely normal and expected, and has an explanation and solution. It happens because Divi uses shortcodes to render modules, and when the Blog module is set to display the “content” of a post, it starts with the first module on the page. If our module is the first, its shortcode may appear in the excerpt. This is not an issue with our plugin and would occur with any module. Here’s what’s happening:

Divi uses shortcodes to render modules. When you choose to display the “content” of a post in the Blog module excerpt, Divi pulls the content starting from the first module on the page. If our Table of Contents module happens to be the first module in the post content, its shortcode will appear in the excerpt.

This issue is not specific to our module—it would happen with any module whose shortcode is longer than the character limit of the Blog module’s excerpt. When the closing tag of the shortcode is cut off, the raw code becomes visible in the excerpt.

Solution:

To avoid this, we highly recommend using the “Excerpt” option instead of “Content” in the Blog module. Here’s how to do this:

  1. Write a custom excerpt for your posts in the WordPress editor.
  2. In the Divi Blog module settings, navigate to the Content Length dropdown.
  3. Select “Show Excerpt” instead of “Show Content”.

This ensures the excerpt displays properly and avoids any shortcode-related issues.

Heading Not Showing With Responsive Content Tabs Open

If you are using the responsive content feature in Divi to write different text for Desktop, Tablet, and Phone, unfortunately that will not work with the TOC. The way Divi handles this prevents JavaScript from reading the content, and so any headings in a content textarea with the responsive tabs enabled will not show in the table of contents.

Missing Headings In The Table of Contents

If some of your headings are not showing up in the table of contents, it might be due to extra HTML within the heading tags. Our plugin automatically adds an ID to each heading tag to generate the table of contents links. However, if your heading tags contain additional HTML elements, such as spans or other tags, it can interfere with the ID assignment and cause the links to be omitted.

To resolve this, review the headings in your post or page and ensure they do not contain any extra HTML tags inside the heading tags. Keep the heading tags clean to ensure they appear correctly in the table of contents.

Another way to resolve this issue is by adding your own unique ID. This A customer shared this with us when trying to add a superscript registered trademark in some headlines, and this resolves that use case as well.

Links Not Working When Duplicate Headings Used In Content

If you’re using the same heading multiple times in your content, the table of contents links will all point to the first occurrence because identical IDs are generated. To fix this, you need to manually assign unique IDs to each heading in the module’s HMTL tab in Visual Builder when creating your page layout. This ensures that each link in the Table of Contents functions as expected.

FAQs

If you have questions that are not addressed in our documentation, please review the frequently asked questions listed below. We regularly update this section based on common queries from our customers. If you don’t find the answer you’re looking for here or in our other documentation, feel free to contact us for support, and we’ll be happy to assist you.

How does this plugin work?

This plugin adds a new custom Divi module into the existing Divi Visual Builder. Simply go to your Divi Builder, click the gray plus (+) icon to add a new module, and select “Table Of Contents Maker” to get started. The module automatically adds links to the headings in the post content based on the settings you choose. Please check our full plugin documentation for more information about all the features.

How to include or exclude headings in the TOC?

How can I change the links color and hover color?

You can easily change both the link color and hover color directly in our module settings! This works just like most Divi Settings, which have a hover option. Here’s how:

  1. Open the Design tab in the module settings.
  2. Scroll down to the Content Heading Links toggle.
  3. To change the regular link color, simply adjust the Content Heading Link Color setting.
  4. To change the hover color, hover over the Content Heading Link Color setting and click the small icon that looks like a mouse cursor.
  5. This will open the hover tab, where you can set a different color for the links when hovering over them in the Table of Contents.

You can always toggle between the normal and hover states to set each color accordingly. You can follow similar steps for the Content Heading Link Underline setting.

Last updated January 2, 2025
Shopping cart0
There are no products in the cart!
You may be interested in…
$19.00$22.50

Select options This product has multiple variants. The options may be chosen on the product page

$16.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$16.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$19.00$24.00

Select options This product has multiple variants. The options may be chosen on the product page

$20.50$24.00

Select options This product has multiple variants. The options may be chosen on the product page

Graphic showcasing Divi Assistant features and toolset.
From: $69.00 / year

Select options This product has multiple variants. The options may be chosen on the product page

Divi Search Helper Plugin By Pee Aye Creative
From: $29.00 / year

Select options This product has multiple variants. The options may be chosen on the product page

Continue shopping
0