How to Downgrade a WordPress Plugin to a Previous Version
Sometimes, after updating a plugin to the latest version, you may experience an unexpected error or compatibility issue.
In this situation, you can temporarily downgrade the plugin to a previous stable version until the issue is resolved.
Before you downgrade the plugin
Before making any changes:
- Take a complete backup of your website.
- Note the currently installed plugin version.
- Deactivate any website caching.
- Test the downgrade on a staging website when possible.
Download a previous plugin version
Follow these steps to download an older version from your account:
- Log in to your plugin account.
- Go to My Account.
- Open My Dashboard.
- Select Downloads.
- Find the required plugin.
- Choose the previous stable version from the available versions.
- Download the plugin ZIP file to your computer.
Replace the current plugin version
Once you have downloaded the older version:
- Log in to your WordPress admin dashboard.
- Go to Plugins > Installed Plugins.
- Find the plugin you want to downgrade.
- Deactivate the plugin.
- Delete the currently installed plugin.
Deleting the plugin files normally does not remove the plugin settings or saved data. However, creating a backup is strongly recommended.
Install the previous version
- Go to Plugins > Add New Plugin.
- Click Upload Plugin.
- Select the downloaded ZIP file.
- Click Install Now.
- Activate the plugin after installation.
Verify the plugin version
After activating the plugin:
- Go to Plugins > Installed Plugins.
- Confirm that the previous version is installed.
- Test the plugin’s main features.
- Check whether the original error is resolved.
Prevent automatic updates
If automatic updates are enabled, WordPress may update the plugin again.
Temporarily disable automatic updates for the plugin until the compatibility issue is fixed.
Important note
Downgrading should usually be a temporary solution. Older plugin versions may not include the latest security fixes, compatibility updates, or improvements.
Contact the plugin support team and share the error details so they can investigate the issue before you update again.