WordPress.com VIP platform specific
This document is for sites running on WordPress.com VIP.
- As with everything, prefix your script slugs when registering or enqueuing them.
- WordPress core includes jQuery so it’s not necessary to include it in your plugin or theme. Doing so can lead to conflicts and unexpected bugs.
- The jQuery version that is packaged with WordPress is in compatibility mode. This means that
jQuery()needs to be explicitly used, not the
- Avoid usage of scripts not hosted on WordPress.com. There is a comprehensive list of scripts included. All WordPress.com scripts are served by a CDN.
- If you need to register a script that is not part of WordPress, or your theme, make sure to use a packed version if available and make sure that their servers are up for the traffic you will request from them. Fail gracefully.
- Adding a version to the script when enqueueing isn’t necessary. When we concatenate files, we append the filemtime of the last updated file as a cache buster. If the file isn’t concatenated for some reason, we just use the file’s mtime.
- If you’re using any kind of ad blocker or other browser plugin that might modify JS, try turning it off and seeing if the results change
- Use your browser’s built-in developer tools, or freely available developer tool add-ons, to view details of the JS running on your site and any errors it might be producing:
If you do report the issue to us, please make sure to include as much of the information revealed by these tools as possible in your request.