Back to Community

Troubleshooting Kadence Blocks Template Override Issues in Child Themes

Content

Many users of the Gutenberg Blocks with AI by Kadence WP plugin enhance their sites by customizing its block templates. A common customization involves modifying the entry-loop-taxonomies.php template file to change how post taxonomies are displayed. The plugin's documentation often states these templates can be overridden by copying them to a child theme, but sometimes this process doesn't work as expected.

Why This Happens

The most frequent cause of a template override not working is an incorrect file path within the child theme. The plugin expects to find the overridden template in a very specific location. Even a small deviation in the folder name or structure can prevent WordPress from locating and loading the custom file. Other potential causes include caching or a theme with a higher specificity that takes precedence.

How to Fix It: Verify Your Child Theme's File Path

The first and most crucial step is to double-check the file path in your child theme. The correct structure must mirror the plugin's own internal structure precisely.

  1. Navigate to your child theme's directory, typically found in /wp-content/themes/your-child-theme-name/.
  2. Create a new folder named exactly kadence-blocks (without any spaces or alternate spelling).
  3. Copy your modified template file (e.g., entry-loop-taxonomies.php) into this new kadence-blocks folder.

The final, correct path should be:
/wp-content/themes/your-child-theme-name/kadence-blocks/entry-loop-taxonomies.php

Ensure that your child theme's folder name in the path above matches its actual directory name exactly. For example, if your child theme is named kadence-child-cwp, the path must reflect that.

Additional Troubleshooting Steps

  • Clear All Caches: After placing the file, clear any caching mechanisms you have active, including browser cache, any WordPress caching plugins (like WP Rocket), and your server-level cache (if applicable).
  • Check for Theme Conflicts: Temporarily switch to a default WordPress theme like Twenty Twenty-Four to see if the override works. If it does, the issue may be with your main or child theme's functions or specificity. The 'Gutenberg Blocks with AI by Kadence WP – Page Builder Features' team suggests ensuring your theme properly supports child theme functionality.
  • Re-save Permalinks: Occasionally, visiting Settings > Permalinks in your WordPress dashboard and simply clicking "Save Changes" can resolve file path issues.

By meticulously verifying the file path and following these steps, you should be able to successfully override Kadence Blocks templates in your child theme and preserve your customizations through updates.

Related Support Threads Support