A successful subscription platform migration is one where renewals, fulfillment, and billing are never interrupted, and your customers don’t even know something has happened.
A smooth transition is entirely achievable by utilizing the right planning. With WooCommerce Subscriptions, this comes down to choosing the right migration method and checking the details before you go live.
There are 3 main ways to move subscribers into WooCommerce Subscriptions:
- Enter subscribers manually.
- Import subscriber data with a CSV file.
- Build a custom migration process.
While subscriber count matters, focus on how cleanly your existing subscription data fits the new system.
| Pathway | Best for | How to do it |
| Manual subscriber migration | An operation with fewer than 100 subscribers. This takes more hands-on work, but with a small subscriber base, it can be simpler than preparing and validating an import. | Add each of your subscriptions manually via the Add Subscriptions screen in your dashboard. You can connect each one to the right customer, product, billing schedule, and payment method.
|
| Bulk CSV import | When you have hundreds or thousands of subscriptions. This process works best when the source data is consistent and the required payment gateway information can be carried over. | Via the WooCommerce importer extension (which is currently in public beta). You can learn more, download, and test the extension via the Subscriptions CSV Importer GitHub Repository. Use the importer’s Test Mode to validate each row before creating subscriptions, so you can fix mapping errors and warnings first.
|
| Custom migration scripts | When migrating subscribers calls for special data or billing handling, custom scripts are the way to go. Custom code is best when the standard importer can’t cleanly handle the migration due to complexity, like when you need to bring over specific records or if you work with a non-standard payment gateway. | The Subscriptions developer API gives custom migration script functions for creating those subscriptions and setting the renewal data for each one. Instead of forcing unusual source data into a CSV template, the script translates each record into the right WooCommerce subscription as the tool imports it. WooCommerce stores each subscription as a WC_Subscription object, an extension of the standard WooCommerce order object with additional data for things like billing schedules and next payment dates.
|
Migrating a subscription and moving its saved payment method are different considerations. You can successfully import the customer, product, billing schedule, and next renewal date, but you’ll need to do a bit more work to set up subscription renewals.
That’s because payment processors don’t hand WooCommerce a customer’s card number. They store cards securely and provide payment tokens that point back to the stored card. WooCommerce Subscriptions requires the right payment token, along with any other gateway-specific payment data, to tell the processor which saved payment method to charge.
When you change gateways, those data reference points won’t automatically follow the subscription to a new payment setup. In some cases, you’ll need to update payment tokens manually or ask subscribers to update their payment method. This depends largely on the payment gateway you use.
Examples of migration paths for different gateways
Stripe is a good example of what clean payment gateway mapping looks like. WooCommerce Subscriptions uses a Stripe Customer ID and Payment Method ID to connect a subscription to the card Stripe has stored.
If your old system already stores those IDs in a compatible format, you can connect them to the migrated subscription. If it stores them differently, you’ll need to translate that data or ask customers to update their payment information.
PayPal requires a bit more work. You can’t import existing PayPal Standard subscriptions into WooCommerce Subscriptions. PayPal Standard relies on payment notifications tied to the original site, and PayPal doesn’t reliably let that connection move with the subscription.
That means that you’ll either need to allot time to manually reattach each subscription to its payment method or prompt subscribers to update it themselves from My Account → Subscriptions.
A successful import doesn’t mean you’re ready to turn on renewals. Before you go live, there are a few important questions to ask:
- Has the old system stopped charging customers?
- Do imported subscriptions point to the right products?
- Are the next payments scheduled for the right day?
Make sure only one system can collect the next renewal
Moving a subscription into WooCommerce Subscriptions doesn’t necessarily tell your old platform to stop billing — and you don’t want customers to be billed twice. How you shut off renewals depends on the system, so verify the process and add it to your checklist.
Verify that subscriptions are connected to the right products
In the CSV importer, each subscription’s line items must point to products that exist in the new store. Product IDs from the old system won’t help if they don’t match the right products in WooCommerce.
Map product data before importing, then spot-check it afterward. A subscription that renews on time but delivers the wrong product will frustrate customers.
Check the next payment date
WooCommerce Subscriptions needs to know how often a customer pays (weekly, monthly, annually) and when each customer pays next. The CSV importer accepts an explicit next_payment_date.
If one isn’t provided, WooCommerce can calculate a date from the subscription’s start or trial date and billing schedule. For an existing subscriber base, compare imported next-payment dates with the source system so customers stay on the schedule they already expect.
Confirm your live store is taking payments
WooCommerce Subscriptions has a Staging Mode that disables automatic payments on a duplicate site.
Before launch, check WooCommerce → Status and confirm the production store is in Live Mode and any testing copy is in Staging Mode.
Don’t rely on the word “staging” in a URL. WooCommerce Subscriptions determines the URL based on several factors, so always double-check.
Spot-check the migration
As a final step, pick subscriptions with different products, billing schedules, statuses, and payment methods, and compare the imported record with the source.
The goal isn’t merely to see that 2,000 rows became 2,000 subscriptions. Spot-check enough subscriptions to confirm details like product ID, payment method, status, and next renewal date.
Subscribers whose payment information carries over cleanly during migration shouldn’t need to do anything.
Focus on reaching out to customers who need to take action. For instance, if certain subscribers are using a payment method like PayPal Standard that can’t be transferred over, send them a separate email before their next renewal.
Utilize tools like Import Export Suite to export subscriptions, filter them by payment method, and then send bulk emails through your marketing tool. Clearly explain what has changed, what action they need to take, and by when.
Consider using the following email template, adjusting it to suit your specific situation:
Subject: Please update the payment method for your [Brand] subscription
We have upgraded our subscription management system to enhance customer service. Your subscription remains active, but the saved payment method for automatic renewals could not be transferred. Kindly update your payment method before the next renewal on [date] to ensure uninterrupted service:
[Button/link: Update payment method]
Rest assured, your products, pricing, and renewal schedule remain unchanged. Should you have any questions, feel free to reply to this email for assistance.
Once the migration is live, monitor the initial batch of subscriptions reaching their renewal date to avoid double-billing customers. Ensure each subscriber is correctly charged by the new system on the right date, generating the expected orders and maintaining the subscription status.
While a failed renewal may not indicate migration issues, recurring payment problems may require further investigation. In case of anomalies, start by examining a single affected subscription and reviewing the associated order notes. Additionally, check WooCommerce → Status → Scheduled Actions for failed or stalled renewal actions and review gateway and scheduled-action logs at WooCommerce → Status → Logs for payment-related issues.
Silence from customers serves as a positive indicator of a successful migration. A seamless transition minimizes support queries about duplicate charges and prevents confusion over renewal processes.
Following the migration, WooCommerce Subscriptions takes over recurring tasks, automating renewals, featuring an automatic payment retry system, supporting multiple gateways, and enabling customers to update payment details independently.
While a migration demands meticulous attention, the long-term benefits include a streamlined subscription operation with reduced customer disruptions. Begin by selecting a migration path that aligns with your subscriber base, payment gateway, and data structure. Could you please rewrite the following sentence?
