How to Update a Premium WordPress Plugin Manually
Premium plugins distributed outside WordPress.org do not always ship with automatic updates, so sooner or later you will need to update one by hand (why such plugins circulate without the vendor’s update channel is covered in our GPL licensing explainer). Done right, a manual update keeps every setting and takes five minutes.
What you need first
- The new version as a ZIP file — if it did not come from the vendor directly, check it for tampering first.
- A backup of the site — at minimum the database and the
wp-content/pluginsfolder; the free UpdraftPlus covers both. - Five minutes of low traffic. Updates are fast, but you will briefly replace live code.
Good news: plugin settings live in the WordPress database, not in the plugin folder. Replacing the files does not wipe your configuration.
Method 1: Dashboard replace (WordPress 5.5+)
- Go to Plugins → Add New Plugin → Upload Plugin.
- Choose the new ZIP and click Install Now.
- WordPress detects the existing install and shows a comparison screen. Click Replace current with uploaded.
The old files are swapped for the new ones and the plugin stays active with its settings intact. This is the cleanest path for most people.
Method 2: Manual replace over FTP
Use this when the uploader refuses the file or the ZIP is too large.
- Extract the new ZIP locally.
- Connect by FTP and open
wp-content/plugins/. - Rename the existing plugin folder to
plugin-name-old— an instant rollback copy. - Upload the extracted new folder as
wp-content/plugins/plugin-name. - Open Plugins → Installed Plugins and confirm the plugin is still active and shows the new version number.
- Test the site. If something broke, delete the new folder and rename
plugin-name-oldback — you are exactly where you started.
After the update
- Read the changelog for the version you installed. Look for “requires re-saving settings”, database upgrade notices, or dropped features.
- Watch for a database-upgrade prompt. Some plugins (WooCommerce, LMS and form plugins especially) show an admin notice asking you to run an updater. Do it, and let it finish.
- Clear caches — page cache, server cache and CDN — so visitors get the new assets.
- Test the critical path: forms submit, checkout completes, logins work. Check the PHP error log for new warnings.
Mistakes to avoid
- Do not delete the plugin from wp-admin before uploading the new version. Deleting runs the plugin’s uninstall routine (
uninstall.php), and some plugins wipe their settings, custom tables and stored data along with the files. Replace files instead — and if the plugin holds data you cannot afford to lose, rehearse the whole update on a staging copy first. - Do not upload a bundle ZIP directly — extract it and install the inner plugin ZIP.
- Do not skip versions blindly on complex plugins. If you are several major versions behind, check whether the vendor recommends intermediate upgrades.
Keep the previous version’s ZIP until you have run the site for a day or two. If a subtle regression shows up, rolling back with the same routine takes another five minutes.