My site is broken

In this article, you will learn the basic troubleshooting process used to solve layout issues caused by WP Rocket.

With this process, you will be able to find the problematic feature, and fix your site without having to deactivate WP Rocket permanently.

Important! If you have multiple display issues, you should perform this process for each issue. It’s important to deal with one problem at a time.

These are the steps of the basic troubleshooting process:

1. Confirm if WP Rocket is really causing the problem

Firstly, check the affected page while bypassing WP Rocket, by adding the ?nowprocket query string to the end of the URL, like this:

https://yourdomain.com/page/?nowprocket

If the problem is not solved, WP Rocket's optimizations are not the cause, and, you should seek for help outside WP Rocket.

But if the issue is solved, one of the optimizations is causing it. In this case, please continue with the next steps in this article.

2. Find the problematic optimization

Follow these steps to identify which specific optimization is causing the problem:

1. Disable all the options in the File Optimization and Media tabs.
2. Test your site again using an incognito window where you’re not logged in as a WordPress user.
3. If the problem is not solved, one of the automatic optimizations may be causing it. In this case, please contact support.
4. But if the problem is solved, turn the options back on, one by one, testing again each time to determine which option has caused the problem.
   
   Important! Remove Unused CSS works asynchronously. Here's how you can check if it's applied.
   
   When you've found the problematic feature, please continue with the next step of this article.

3. Choose the solution

Once you know the problematic option, you can either:

• Follow the specific guide that will help you target and exclude the affected elements.
  
  This is the most common solution, as it balances optimization with a targeted fix.
• Turn off the option only on problematic pages.
  
  This is the easiest way to fix a problem if there's only one or a few affected page(s). It doesn't affect the speed for the rest of the site.
• Turn off the option for the whole site.
  
  This option should be used only when the problem impacts most of the site, and using the above options don't work.

Available troubleshooting guides

The following is a non-exhaustive list of the most common troubleshooting guides available for the different optimizations:

• Remove Unused CSS
  • Troubleshoot Remove Unused CSS display issues
• Delay JavaScript execution
  • Delay JavaScript Execution compatibility exclusions
  • Troubleshoot Delay JavaScript execution issues
• Load JavaScript deferred
  • Exclude files from Load JavaScript Deferred
• LazyLoad
  • Disable LazyLoad on specific images
  • Disable LazyLoad on Specific Posts
• Minify JavaScript files
  • Find the right JavaScript files to exclude from minification

Edge cases

If none of the above resolves the issue, you have found an edge case. Please continue as follows:

• Disable WP Rocket completely and check if the issue resolves or not.
  
  If the issue is still there when WP Rocket is off, the cause lies somewhere else. Try switching to a default theme, and then disabling other plugins to find the conflict.
• Make sure your site's WWW and non-WWW redirections are properly set, check this guide.
• Disable any other options in WP Rocket:
  • WebP Compatibility
  • CDN
  • RocketCDN if you have an issue with RocketCDN, untick the Enable Content Delivery Network option from the CDN tab while troubleshooting. Don’t cancel the subscription until our support has had a chance to debug.

Still need help? Send us a support message from our Help Center page.

Please provide as much detail as possible, including URLs and screenshots where the issue can be observed. Additionally, describe what it is expected to see. The more information you share, the better the support can assist you in resolving the issue.