Step 1: Backup your site
Make a complete backup of your site including all site files and the database. Do not skip this step.
Pro-Tip: If you’re unpracticed with backups spend a few minutes on this great “how to” doc by WooCommerce!
How to Update Your Site
Step 2: Update the WC Autoship Plugin
It’s critical that you first update the WC Auto-Ship Plugin to Version 3.2.2 before updating to version 4.0.
This step will ensure that all Autoship Data will migrate to the new version of Autoship and WooCommerce.
Step 3: Deactivate and delete WC Autoship Plugins
Important: Follow the steps below in order!
1: Navigate to the Plugins page in the WP Admin Dashboard.
2: Deactivate and then Delete all WC Autoship Payment Integration plugins including:
- WC Autoship Authorize.net Payments
- WC Autoship Braintree Payments
- WC Autoship Payflow Payments
- WC Autoship PayPal Payments
- WC Autoship Stripe Payments
- etc..
3: Deactivate then Delete all WC Autoship Extension Plugins including:
- WC Autoship Product Page Options
- WC Autoship Upsell
- etc…
4: Delete all Autoship Pages including:
- Autoship Menu
- Autoship Schedules
- Autoship Shipping
- Autoship Billing
Once deleted, delete these pages permanently from ‘Trash’
Pro Tip: You may need to remove these pages from any menus they appear on. The ‘My Account’ page will show Autoship automatically on the tab “Autoship Schedules” once the WC Autoship 4.0 plugin is installed and activated with WooCommerce 2.6.
Step 4: Update the WooCommerce plugin
You should not have any WC Autoship plugins installed on your site at this point. You will need to upgrade WooCommerce before installing WC Autoship 4.
- Navigate to the Plugins page in the WP Admin Dashboard.
- Update the main WooCommerce plugin to version 2.6
- WooCommerce
- Follow the instructions from WooCommerce to complete the upgrade.
- Set up WooCommerce Shipping Zones. Shipping has been completely revamped in WooCommerce 2.6 and you will be required to setup Shipping Zones.
Step 5: Upgrade your license keys
- Log in to your account.
- Click “View Licenses” for your WC Autoship purchases.
- Click “Upgrade License” on all relevant downloads. Upgrades are available for the software below:
- WC Autoship
- WC Autoship PayPal Payments
- WC Autoship Payflow Payments
- WC Autoship Authorize.net Payments
- WC Autoship Stripe Payments
- WC Autoship Braintree Payments
- Download your new plugins and install them on your WordPress site.
Step 6: Migrate Autoship customer payment data
If you have autoship payment data for existing customers, follow the steps below. Otherwise, skip this step and go to Step 7.
- Locate your payment gateway integration.
- WC Autoship PayPal Payments
Migrate PayPal Payments - WC Autoship Payflow Payments
Migrate Payflow Payments - WC Autoship Stripe Payments
Migrate Stripe Payments - WC Autoship Braintree Payments
Migrate Braintree Payments - WC Autoship Authorize.net Payments
Migrate Authorize.net Payments
- WC Autoship PayPal Payments
- Download the appropriate payment migration plugin for your site.
- Install the plugin and follow the instructions in your WP Admin Dashboard.
- After following the plugins prompt to migrate, you can remove the plugin. Clicking its prompt again doesn’t perform any further action.
Note: Migrated payment tokens may display strangely (Credit card ending in “XXXX”) but will still work properly. The lack of detail is only due to descriptive payment details not being available after the payment has been tokenized. Newly entered cards will show the proper descriptive information.
Step 7: Test your upgrade
- Add an Autoship item to the cart.
- Complete the checkout process to create a new order.
- Navigate to My Account > Autoship Schedules. You should see your new Autoship Schedule in the list.
- Make several changes to your Autoship Schedule to confirm that it is working properly.