Help

Troubleshooting

Use these checks to diagnose the most common Car Fitment Pro setup, display, fitment, URL, and sitemap issues.

Test one thing at a time

After every change, clear relevant caches and test again using a specific product and vehicle combination.

Common issues

VF

Vehicle selector is empty

Confirm that vehicle data has been imported or added manually and that make, model, and engine records exist.

PF

Product shows wrong fitment

Check the selected vehicle and verify that the exact vehicle record is connected to the product.

404

Vehicle page returns 404

Go to Settings → Permalinks and click Save Changes to refresh WordPress rewrite rules.

XML

Sitemap does not open

Refresh permalinks, clear caching, and verify that the sitemap URL returns XML rather than a shop or 404 page.

Selected vehicle problems

If the header selector or popup does not update after choosing a vehicle, test with caching disabled. Also check that the page URL is valid and that the selected vehicle still exists in the vehicle database.

Product-fitment problems

If a compatible product displays an incompatible notice, open the product editor and verify the vehicle assignment. Check model, engine, kW, year range, and engine code where relevant. A similarly named vehicle record is not necessarily the same configuration.

Filter problems

Category and attribute filters require an active vehicle. Attribute filters also require global WooCommerce attributes assigned to the matching products. Empty filters often mean that the compatible products do not contain the expected attribute terms.

Caching and optimization

Clear page cache

Clear theme, plugin, server, and CDN caches after changing vehicle data or plugin settings.

Exclude dynamic areas if needed

Vehicle selectors, compatibility status, and vehicle-aware content may need to bypass aggressive full-page caching.

Test logged out

Always test storefront behavior in a private browser window, as administrators can see uncached content.