Troubleshooting

JavaScript Breaks After Plugin Activation

If a script stops working after activating Cacheability Pro, it's likely affected by JavaScript deferring. Some scripts expect to run immediately and break when deferred.

Fix: Add the script's handle to the defer exclusion list:

1. Inspect your page source and find the broken script's id attribute (format: {handle}-js)
2. Go to Cacheability Pro > Page Optimization > Advanced Settings
3. Add the handle (without the -js suffix) to the exclusion list

Cache Diagnostics Shows False Positives

The code scanner may flag code that doesn't actually affect caching:

• Admin-only code is automatically filtered out, but some edge cases may slip through
• Use the Dismiss button to hide findings you've verified are not issues
• Dismissed findings are stored site-wide

Cache Not Working Despite Plugin Being Active

1. Check that your license is active under Cacheability Pro > License & Account
2. Verify your reverse proxy (Varnish/Nginx) is running and receiving traffic
3. Run Cache Diagnostics > Live Capture to detect what's preventing caching
4. Check for other plugins setting no-cache headers

Images Still Cause Layout Shift

Image dimensions are only added to images in post content and text widgets. Images added via:

• Theme templates
• Custom PHP code
• Page builders with their own rendering

...are not processed. These need dimensions added at the source.

Getting Help

For support, visit getpagespeed.com/contact.