Troubleshooting & Compatibility
Broken layouts, errors, and unexpected behavior.
“realpath(): open_basedir restriction in effect. File(/) is not within the allowed path(s)” error
This error happens when PHP has its access limited by the value of open_basedir PHP setting. open_basedir limits the files that can be accessed by PHP to the directory-tree it is specified on this setting. And setting a wrong value can be…
“Sorry, you’re not allowed to access this page” error
This is not something that could be triggered by WP Rocket. You can verify that by enabling WordPress Debugger and see if there is anything related to WP Rocket showing here. It usually affects access to other plugins as well.…
404 errors on minified or combined CSS/JavaScript files
Under normal circumstances, you should not find 404 errors on the minified or combined files created by WP Rocket. However there are a few external factors which can affect this.Google cache Google keeps its own cache of sites, at a…
502 or 504 error when manually clearing the cache
If you see a 502 error from Cloudflare or 504 Gateway Time-out from NGINX when clearing the WP Rocket cache, please check if you are also using the Query Monitor plugin. In some cases, this combination can lead to the 502/504 error. …
AdRotate and AdRotate Pro
To use ad rotation with caching, choose the Dynamic Mode setting in AdRotate: There may be other features in AdRotate which aren't compatible with page caching and require fragment caching instead (which we don't support). If you do encounter issues…
Browser downloads file when opening a page
Problem When trying to visit pages on your website, instead of the page opening normally, you get a popup asking you to download a file. On Firefox it looks like this: On Chrome, you will be prompted to open a…
Can I exclude a shortcode from the cache?
It's not possible to exclude the output of a shortcode from being cached. That would require fragment caching which WP Rocket doesn't support. Page caching caches the entire output of the page. If your shortcode requires PHP to update its…
Can’t Download Files (PDFs, .json, .ical) When WP Rocket is Active
If your site is hosted by OVH, you might encounter issues where certain files (like PDFs, .json settings files, or .ical export files) cannot be downloaded when WP Rocket is active. This is an OVH-specific problem caused by a conflict…
Captcha is not working
If you are using a Captcha solution on your website, and it has stopped working when WP Rocket is enabled, there could be two possible reasons: Conflict with File Optimization features. Verify this by disabling all the options on the…