If Caddy isn’t behaving as expected, work through these steps — they resolve the vast majority of issues.
1. Update everything
Make sure you’re running the latest versions of Caddy (and Caddy Pro), WordPress, WooCommerce, and your theme. Caddy 3.0 requires WordPress 6.5+, PHP 7.4+, and WooCommerce 7.0+. If you’re on Caddy Pro, your license must be active to receive Pro updates.
Upgrading from 2.x? The free plugin and Caddy Pro must both be on 3.0+ — a 2.x Pro version is not compatible with the 3.0 free plugin, and you’ll see an admin notice until both are updated.
2. Clear your caches
After updating, clear every cache layer: page caching plugin, server/host cache, CDN, and your browser. Caddy 3.0 is built to coexist with page caching — it refreshes its security tokens automatically on cached pages and excludes itself from WP Rocket without any manual configuration — but a stale cache from before an update can still serve old assets.
3. Check for plugin conflicts
Temporarily deactivate your other plugins (everything except Caddy and WooCommerce) and check whether the issue goes away. If it does, reactivate them one at a time to find the culprit. Do this on a staging site if you have one — staging sites don’t consume a license activation.
Also check the known plugin and theme compatibility issues list for documented conflicts and workarounds.
4. Check for theme conflicts
Switch briefly to a default theme (Twenty Twenty-Five or Storefront). If the issue disappears, the conflict is in your theme — most commonly aggressive CSS targeting Caddy’s elements or a theme’s own side-cart feature running alongside Caddy (disable the theme’s mini cart if it has one).
5. Enable logging (Pro)
For tracking, workflow, or analytics issues, switch on Enable Logging under Caddy > Settings > General. Caddy writes detailed diagnostic output to your PHP error log, which is enormously helpful to include in a support request.
6. Data tools (Pro)
Caddy > Settings > Tools includes maintenance utilities: clear Caddy’s cached transients, detect and clean up duplicate cart records, and check whether the database schema needs an update. Try “Delete Caddy Transients” if settings changes don’t seem to take effect.
Still stuck?
Contact support with: your Caddy, WordPress, and WooCommerce versions; your theme; what you expected vs. what happens; and any relevant log output from step 5.