Exclude files from Load JavaScript Deferred
If this option causes any problems, you may need to exclude a file from the process.
Exclude files and domains
You can use the field in the plugin settings to exclude files:
Exclusions may be done by using any of the following:
- Full file URLs (with query strings removed)
- Keywords from the file URL
- Wildcards
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.
Exclude inline scripts
You can use the rocket_defer_inline_exclusions
filter to exclude specific inline scripts from being deferred, like this:
add_filter( 'rocket_defer_inline_exclusions', function( $inline_exclusions_list ) { $inline_exclusions_list[] = 'key_from_target_script'; return $inline_exclusions_list; } );
You'd need to replace key_from_target_script
with a string of your real inline script.
You can add the above script as shown in the Add Code Snippets guide.
Note: if any jQuery library is excluded, WP Rocket won't defer inline JavaScript.
Examples
Exclude an externally hosted file
<script src="//maps.googleapis.com/maps/api/js?key=AIzaSyBusRuOn8uzsREWbwi-KCU4puf0me2aj3A&libraries=places" type="text/javascript"> </script>
You could simply use the domain:
maps.googleapis.com
This applies to external files that weren't minified by WP Rocket, and thus, kept their original external domain name.
Exclude a single file
To exclude this file:
https://example.org/wp-content/plugins/elementor-pro/assets/js/frontend.min.js?ver=3.0.5
Use the following:
https://example.org/wp-content/plugins/elementor-pro/assets/js/frontend.min.js
Exclude a group of files
To exclude all files from a specific plugin folder, you could use a wildcard:
https://www.example.org/wp-content/plugins/my-plugin/assets/js/um-crop.min.js?ver=2.1.12
Use the following:
/wp-content/plugins/my-plugin/assets/js/(.*).js
Exclude a minified file
To exclude a file which is also minified, the exclusion has to be based on the minified file URL. So choose a part of the URL (excluding the domain) which is unchanged by minification.
To exclude this file:
https://www.example.org/wp-content/cache/min/1/wp-content/plugins/plugin-name/assets/js/pickadate/picker.time-f9a2f2b5fb728f25892f2f41b6f8a4b9.js
Use the following:
plugin-name/assets/js/pickadate/picker.time