Help
Troubleshooting
Use these checks to diagnose the most common Car Fitment Pro setup, display, fitment, URL, and sitemap issues.
After every change, clear relevant caches and test again using a specific product and vehicle combination.
Common issues
Vehicle selector is empty
Confirm that vehicle data has been imported or added manually and that make, model, and engine records exist.
Product shows wrong fitment
Check the selected vehicle and verify that the exact vehicle record is connected to the product.
Vehicle page returns 404
Go to Settings → Permalinks and click Save Changes to refresh WordPress rewrite rules.
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 theme, plugin, server, and CDN caches after changing vehicle data or plugin settings.
Vehicle selectors, compatibility status, and vehicle-aware content may need to bypass aggressive full-page caching.
Always test storefront behavior in a private browser window, as administrators can see uncached content.