Resolving issues with Minify CSS files
To resolve display issues that may occur when Minify CSS files is active, please take the following steps:
- Install the Blue Button Chrome extension or alternatively, you can use this external tool.
- Enter the URL of the page with the CSS issue, and add
?nowprocketto the URL, e.gexample.com/about?nowprocket.
This bypasses WP Rocket, so that you can find the original URLs (unmodified by WP Rocket) of all CSS files. - Click on Stylesheets or Scripts to get the list of internal and external CSS and JavaScript files on your site.
- Copy the list of CSS files, then go to WP Rocket Settings > File Optimization and paste the list into the Excluded CSS Files field:
- Save the settings and check your site, in a logged-out or incognito window. It should now be displaying correctly.
- Now remove each file from the list, one-at-a-time. After each removal, save the settings and check your site. Repeat this until the website is broken again.
- When the website breaks, replace the last removed file back into the list and move onto the next file.
Excluding files from external domains
Files from external domains can be excluded either by the domain name or the full file URL.
e.g. to exclude: https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css
You may use either: stackpath.bootstrapcdn.com
or https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css
Note: this method can also be used for issues with Minify/Combine JavaScript files (using the JS Files and Inline JS results in the asset detector tool), but the method described here is faster.
Also, this can be used for the Combine CSS files feature if you're using a WP Rocket version before 3.15.
Heads up!
Certain patterns of exclusions cannot be handled and are automatically removed.
If you add them, you should see a notice with the "WP Rocket: The following patterns are invalid and have been removed" message.
Please see more in our Invalid patterns of exclusions article.