Menu

Resolving the jQuery compatibility issue in WordPress 5.5, 5.6, 5.7

Updated on June 1st, 2022

The release of WordPress 5.5 removed jQuery 1.x and replaced it with jQuery 3.x, which will make WordPress more secure and efficient.

As a result, upgrading to WordPress 5.5, 5.6, or 5.7 could result in site issues such as missing content, buttons no longer working, and layout/display issues for sites running plugins and themes not compatible with jQuery 3.x. These issues could occur on both the site’s frontend and/or the WP admin area.


What is jQuery?

jQuery is a JavaScript library that supports many of the functions in WordPress. Oftentimes, WordPress developers will customize jQuery for their own themes and plugins.


How to address the issue in WordPress 5.7

WordPress 5.7 drops support for the Enable jQuery Migrate Helper plugin that was effective in previous WordPress versions (see below). To ensure your site continues to run smoothly, consider the following actions:

  • Many developers have already made their plugins and themes compatible with jQuery 3.x. Be sure to update all plugins and themes on your site to promote jQuery compatibility on your site.
  • If a particular plugin or theme is not compatible, switch to an alternative that is compatible.
  • Lastly, you can downgrade to a prior version of WordPress, like 5.6. This can be done from the Advanced tab of the site’s Flywheel dashboard, and will allow the site to leverage the Enable jQuery Migrate Helper plugin. This should be considered as a temporary measure and used as a last resort.

How to address the issue in WordPress 5.5 and 5.6

If your site experiences these symptoms after updating to WordPress 5.5 or 5.6, the quickest option to restore functionality is to install the free Enable jQuery Migrate Helper plugin.

This plugin will re-enable the jQuery Migrate tool that was removed in WordPress 5.5, and can even provide clues about what plugin or theme is having problems. It’s important to note that this plugin does not permanently fix the conflicts, it’s just a way to restore functionality.

Note

Keep in mind, both of these fixes are temporary. The ideal resolution is for the plugin or theme developer to update their code and for users to install these updates as soon as they are available.

Plugins and themes with outdated code are a potential security risk, so it’s best practice to use only actively developed plugins. In some case it may be best to look for an alternative plugin or theme.


Additional warnings in WordPress 5.6

If you’re running WordPress 5.6, there is an additional option available in the plugin settings called Capture modern deprecations. Enabling this option may report many entries from WordPress itself. This is expected, as WordPress continues to update its own code in upcoming releases.

To see warnings from plugins/themes only, disable this option.

Was this article helpful?

Getting Started

New to Flywheel? Start here, we've got all the information you'll need to get started and launch your first site!

View all

Account Management

Learn all about managing your Flywheel user account, Teams and integrations.

View all

Billing

Everything about billing, invoices and payments can be found here.

View all

Features

Flywheel hosting plans include a ton of great features. Learn about how to get a free SSL certificate, set up a staging site, and more!

View all

Platform Info

All the server and setting info you'll need to help you get the most out of your Flywheel hosting plan!

View all

Site Management

Tips and tricks for managing your sites on Flywheel, including going live, troubleshooting issues and migrating or cloning sites.

View all

Growth Suite

Learn more about Growth Suite, our all-in-one solution for freelancers and agencies to grow more quickly and predictably.

View all

Managed Plugin Updates

Learn more about Managed Plugin Updates, and how you can keep your sites up to date, and extra safe.

View all

 

Flywheel help

Help is just a click away! Log into the Flywheel dashboard to instantly chat with an expert, open a ticket, or follow along with in-depth documentation. We happily offer support 24 hours a day, 7 days a week, 365 days a year!

Log in

Try Flywheel today

Launch your next WordPress site in minutes.

 Free migrations  24/7/365 support  14 day demo sites