Table of contents compability

Hello,

We apologize for the issue you are facing with Rank Math not detecting the Table of Contents in your blog post template using the Breakdance builder plugin.

Currently, Rank Math checks for specific Table of Contents creation plugins to determine if a TOC is present. If the Breakdance builder does not have built-in compatibility recognized by Rank Math, it may not be detected automatically.

To resolve this, you can add a filter to your theme’s rank-math.php file to inform Rank Math about the TOC plugin you are using. Here’s how you can do that:

1. Create or edit the rank-math.php file in your theme. You can find this in the WordPress Dashboard under Appearance → Theme File Editor.

2. Add the following code snippet:

   add_filter( 'rank_math/researches/toc_plugins', function( $toc_plugins ) {
      $toc_plugins['plugin-directory/plugin-filename.php'] = 'Breakdance TOC';
      return $toc_plugins;
   });

   Make sure to replace plugin-directory/plugin-filename.php with the actual path to your TOC plugin file inside the WordPress plugins folder.

3. Save the changes.

Once you’ve added this code, Rank Math should be able to detect that you are using a Table of Contents section in your posts. We recommend adding this code to a child theme to prevent any loss of changes during theme updates.

For more details, you can refer to our article on Why Isn’t Rank Math Detecting the Table of Contents?.

Thank you for raising this concern, and we hope this helps resolve the issue!

Sources:
Why Isn’t Rank Math Detecting the Table of Contents? » Rank Math
How to Use a Table of Contents to Improve Content Readability » Rank Math