Symptom
↑ Back to topStores still on WooCommerce Subscriptions 2.x that update straight to the latest version see this notice in WordPress admin:
“A database upgrade is required to use Subscriptions. Upgrades from the previously installed version is no longer supported. You will need to install an older version of WooCommerce Subscriptions or WooCommerce Payments to proceed with the upgrade before you can use a newer version.”
The fix is to upgrade in two stages: first to 3.1.5, then to the latest version.
Supported upgrade path
↑ Back to topStores on Subscriptions 2.x can upgrade 2.x → 3.1.5 → latest.
There’s no need to step through earlier 3.x releases. Version 3.1.5 runs the Action Scheduler migration introduced in 3.0 and the intermediate releases, so stores can go straight to it.
Before you start
↑ Back to top- Back up the site. Take a full backup, including the database.
- Use a staging site. Run the upgrade on staging first, then repeat it on the live site.
- Check the WooCommerce database version. Subscriptions 3.1.5 requires the WooCommerce database to be at version 3.7 or later.
Upgrade steps
↑ Back to top- Get version 3.1.5. Contact WooCommerce support for the 3.1.5 zip file. You need an active WooCommerce Subscriptions subscription on WooCommerce.com.
- Update the plugin to 3.1.5. Replace the installed 2.x version with 3.1.5: go to Plugins > Add New > Upload Plugin, upload the zip, and choose Replace current with uploaded.
- Start the database upgrade. Installing 3.1.5 only replaces the plugin files. The database upgrade runs the next time an administrator loads a page in WordPress admin. After the plugin is replaced, go to Dashboard (or any other admin page) to start it.
- Confirm the upgrade has finished. Check Scheduled Actions and the logs to confirm that the applicable repairs and any scheduler migration have finished.
- Update to the latest version. Once step 4 is done, update WooCommerce Subscriptions to the latest version.
Stores on 2.0.0 or 2.0.1 that came from 1.x
↑ Back to topIf the store is on Subscriptions 2.0.0 or 2.0.1 and was previously upgraded from 1.x, you might need to complete a database repair on 2.0.2 first. Contact WooCommerce support for assistance.
Questions and support
↑ Back to topSomething missing from this documentation? Still have questions and need assistance?
- If you have a question about a specific extension or theme you’d like to purchase, contact us to get answers.
- If you already purchased this product and need some assistance, get in touch with a Happiness Engineer via our support page and select this product’s name from the Product dropdown.