Resolve plugin or theme conflicts
Identify and fix conflicts between Chamevo and other WordPress plugins or themes.
WordPress plugins and themes can conflict with Chamevo in several ways β JavaScript errors, CSS overrides, WooCommerce hook interference, or resource loading issues. This guide walks through the standard process for isolating and resolving conflicts.
Symptoms
- The customizer loads partially or with broken UI elements.
- JavaScript errors appear in the browser console referencing a different plugin.
- CSS from the theme overrides the customizer's styling.
- The customizer works on a fresh WordPress install but not on your site.
- A specific feature (upload, add to cart, 3D preview) fails while others work.
Step 1: Confirm it is a conflict
- Open the browser developer tools (F12 β Console).
- Reload the product page.
- Look for JavaScript errors. Note which script file causes the error β the filename or path usually reveals the source plugin.
- If the error is in a Chamevo file, it may be caused by a missing dependency that another plugin removed.
Step 2: Isolate the conflicting plugin
- Deactivate all plugins except Chamevo and WooCommerce.
- Switch to a default WordPress theme (Twenty Twenty-Four or Storefront).
- Test the customizer. If it works, the conflict is with a plugin or the theme.
- Reactivate plugins one at a time, testing the customizer after each.
- When the customizer breaks, you have found the conflicting plugin.
Step 3: Isolate a theme conflict
If the customizer works with the default theme but not your theme:
- Enable Debug Mode in Chamevo β Settings β Advanced β Troubleshooting.
- Open a product page β the Theme Check modal shows missing WooCommerce hooks.
- If hooks are missing, the theme does not support standard WooCommerce templates.
- See Debug missing WooCommerce hooks.
For CSS conflicts:
- Inspect the customizer elements in the browser developer tools.
- Look for CSS rules from the theme that override Chamevo's styles.
- Add more specific CSS rules or
!importantdeclarations to fix the visual issue.
Common plugin conflicts
Page builders (Elementor, WPBakery, Divi)
Page builders may load their own JavaScript frameworks that conflict with the customizer's canvas rendering.