Skip to content
FFuzzy

How-to

Troubleshoot Theme Conflicts

Diagnose stale products, pagination, counts, sorting, mobile layout, cache, and template conflicts.

Updated May 25, 2026SEO-ready

When to use this

Use this when the filter works in some setups but breaks in yours — products do not update, the layout looks wrong, or filtering does nothing on a page built with a page builder.

Before you start

  • You can reproduce the problem on a specific page.
  • You can temporarily switch themes or disable a plugin on a staging copy.

Steps

  1. Reproduce and locate. Confirm the exact page and which part fails:

    2. products, count, pagination, sort, or layout.

  2. Check selectors first. Custom themes and builders often rename the product

    3. loop. Correct the AJAX selectors before anything else — see *Configure AJAX selectors for a custom theme*.

  3. Isolate the source. On a staging copy, switch to a default WooCommerce

    4. theme and test. If it works, the theme markup is the cause. If not, test with other plugins disabled.

  4. Test the page builder loop. A builder may render its own product loop

    5. instead of the WooCommerce one. Point the filter at the loop the builder actually outputs, or use the builder's WooCommerce loop element.

  5. Check the cache. A cache plugin can serve a stale filtered page. Exclude

    6. the filtered storefront from full-page cache, or clear the cache and retest.

  6. Apply the narrowest fix that resolves it and retest the original page.

Expected result

The conflict is traced to a specific source — theme markup, builder loop, or cache — and resolved with a targeted change, usually a selector or cache rule, rather than disabling features.

Troubleshooting

  • Works after switching to a default theme. Fix the selectors for the custom

    • theme rather than keeping the default theme.

  • Works after clearing cache, breaks again later. Add a cache exclusion for

    • the filtered pages instead of clearing cache by hand.

  • How-to: Configure AJAX selectors for a custom theme.
  • Explanation: How compatibility and selectors work with custom themes.
  • Reference: Plugin Settings — Compatibility.