Migrate from EDD Recurring Payments
Moving live subscriptions to another plugin is the scary kind of migration. Get it wrong and customers pay twice, renewals stop without anyone noticing or a subscription you meant to keep is cancelled.
The EDD Recurring Migration module moves EDD Recurring Payments subscriptions into Stackless with their dates, prices and past orders. You choose per payment method what moves and what stays, and EDD Recurring keeps renewing the ones you leave on it. Whatever moves is cancelled in EDD Recurring, and at Stripe or PayPal when they billed it, before Stackless takes over. Each subscription is billed by one plugin only.
Before You Start
- Go to Stackless → Dashboard and switch on EDD Recurring Migration. It’s off by default. While it’s on, the Stackless Subscriptions module runs beside EDD Recurring instead of pausing itself.
- Switch on Subscriptions too. Without it, the import refuses to start with “Switch on the Stackless Subscriptions module first.”
- To move Stripe subscriptions, set up Stripe (Stackless) with API keys for the same Stripe account EDD’s Stripe gateway uses, in the same mode, live or test. See Set Up Stripe Payments.
- To move PayPal subscriptions, set up PayPal (Stackless) with credentials for the same PayPal account EDD’s PayPal gateway uses, in the same environment. See Set Up PayPal Payments.
- Take a database backup.
The migration screen is Stackless → EDD Recurring migration, titled “Migrate from EDD Recurring”. It needs the manage_shop_settings capability. The scan reads EDD Recurring’s own tables, so EDD Recurring can be active or deactivated. If its tables aren’t there, the screen says “No EDD Recurring data was found on this site.”
Choose What Happens to Each Payment Method
The choices live under Stackless → Settings → EDD Recurring Migration, in the Moving from EDD Recurring section. The migration screen lists the current ones with a Change these choices link.
| Setting | Choices | Default |
|---|---|---|
| Stripe subscriptions | Leave them on EDD Recurring; Move them: renew with the customer’s saved card and cancel the Stripe subscription; Move them: renew by pay link and cancel the Stripe subscription | Leave them on EDD Recurring |
| PayPal subscriptions | Leave them on EDD Recurring; Move them: renew by pay link and cancel the PayPal subscription | Leave them on EDD Recurring |
| Other payment methods | Move them: renew by pay link; Leave them on EDD Recurring | Move them: renew by pay link |
Stripe means EDD’s own Stripe gateway, and PayPal means EDD’s PayPal Commerce gateway. Every other gateway, including PayPal Standard and manual payments, counts as Other payment methods.
Two more settings sit in the same section:
- Ended subscriptions: also bring over cancelled and expired subscriptions as history. On by default.
- Download settings: after the import, turn the EDD Recurring settings of downloads whose subscriptions moved into Stackless subscription plans, so new sign-ups go to Stackless. On by default.
The payment method choices only decide what happens to live subscriptions: Active, Trialling and Failing in EDD Recurring. Ended ones come over as history whatever you pick.
What Each Choice Does at the Provider
| Choice | What happens |
|---|---|
| Leave them on EDD Recurring | Nothing changes. EDD Recurring keeps renewing the subscription as before. |
| Renew with the saved card (Stripe only) | Stackless’s Stripe gateway reads the Stripe subscription and saves the card it charges, its default payment method or else the Stripe customer’s default, as a Stripe (Stackless) payment method. Then it cancels the Stripe subscription. Stackless renews automatically on the same card. |
| Renew by pay link | A Stripe or PayPal subscription is cancelled at the provider first. Stackless then emails a renewal invoice for each renewal. |
- Cancelling at Stripe or PayPal takes effect right away, with no proration, final invoice or refund. A subscription already cancelled there counts as done.
- Only subscriptions the provider bills are cancelled there: Stripe subscriptions with a
sub_ID and PayPal subscriptions with anI-ID. PayPal subscriptions that EDD Recurring charges itself from a saved PayPal account only need EDD Recurring stopped. - PayPal subscriptions can’t move with the saved account, because the buyer would have to approve it again. Moved ones renew by pay link.
- A Stripe subscription set to move with the saved card renews by pay link instead when no Stripe subscription or Stripe customer is found. The report says so.
- For Other payment methods, nothing is cancelled at a provider. Only EDD Recurring’s record is stopped.
Scan and Read the Report
On Stackless → EDD Recurring migration, click Scan EDD Recurring. The scan only reads and changes nothing in EDD Recurring. It runs in the background, 50 subscriptions at a time, and the page refreshes every 10 seconds until it says how many it scanned.
Scan again replaces everything not imported yet. Subscriptions already imported stay as they are. Scan again after you change a choice, and right before you import: EDD Recurring sign-ups after a scan are only in the next one.
| Row | What it counts |
|---|---|
| To import | Subscriptions that will come over. |
| Imported | Subscriptions already in Stackless. |
| Stay on EDD Recurring | Live subscriptions your choices leave on EDD Recurring. |
| Left out | Subscriptions that won’t be imported, each with a reason. |
| Failed | Subscriptions the import tried and stopped on with an error. |
| Renew with the saved card | Live subscriptions moving to automatic renewal through Stripe (Stackless). |
| Renew by pay link | Live subscriptions moving to emailed renewal invoices. |
Worth checking lists up to 200 subscriptions that have a note, with the EDD Recurring number, the Stackless number once imported, the result and the notes. A subscription is left out when it already moved, was never paid (Pending), has ended while Ended subscriptions is unticked or has an unsupported period, no download, no currency, no start date, no customer email or no renewal date while active.
Imported subscriptions can carry notes too:
- How it will renew, and that the subscription at the provider is cancelled first when there is one.
- The renewal date has passed. Stackless renews it right after import.
- It has an unpaid renewal order. That order stays payable, and paying it renews the subscription.
- Guest subscription, or a download that no longer exists. A missing download’s line keeps its name and price.
How Statuses Map
| EDD Recurring | Stackless |
|---|---|
| Active | Active, next payment on EDD Recurring’s expiration date |
| Trialling | Trial, ending on the expiration date |
| Failing | On hold |
| Cancelled, expiration still ahead | Pending cancellation, ending on that date |
| Cancelled, expiration passed | Cancelled, as history |
| Completed, expiration still ahead | Active with an end date and no more renewals |
| Completed or Expired, expiration passed | Expired, as history |
| Pending and anything else | Left out |
Day, week, month and year periods carry over as they are. A quarter becomes every 3 months and a semi-year every 6 months. Any other period leaves the subscription out.
What Carries Over
- The EDD customer, WordPress user, email and name, and the currency of the first order
- The download and price option, with the recurring amount EDD Recurring charges and its tax
- The billing period, how many times it bills, the start, next payment, end and last payment dates, and how many periods were paid
- The first order and past renewal orders, linked to the new subscription. Paid ones count as paid. An unpaid one stays payable, and paying it renews the subscription.
- A note on the Stackless subscription, such as “Imported from
edd_recurring:123. EDD Recurring subscription #123.”
The import charges nothing and sends no emails. Each subscription is saved straight into its status, then its renewal schedule is built from its dates.
What doesn’t carry over:
- Signup fees and trials of running subscriptions. Their dates already include the trial.
- Saved PayPal approvals. Moved PayPal subscriptions renew by pay link.
- Saved methods from any gateway other than Stripe.
- The billing address.
Import
- Scan again just before you import.
- Check that the import step reads “Stackless Subscriptions: running”.
- Tick “I have read what will happen. Nothing is charged by the import itself.”
- Click Import. The button shows how many subscriptions it will bring over.
The import runs in the background, 20 subscriptions per batch, and the page refreshes every 10 seconds. For each subscription it saves the Stripe card for a move with the saved card, cancels the Stripe or PayPal subscription when the provider bills it, and marks EDD Recurring’s record Cancelled with a note. Then it creates the Stackless subscription and links its orders.
If Stripe or PayPal refuses, the subscription is marked Failed with the reason and nothing is imported for it. EDD Recurring keeps billing it.
- Resuming: a batch that stops partway leaves the rest in To import. Click Import again to pick them up.
- No duplicates: each Stackless subscription remembers its EDD Recurring number, and EDD Recurring’s record keeps the Stackless number, so a rerun never creates a second copy.
- Failures: fix the cause, then click Try the failed ones again. It moves failed subscriptions back to To import and runs the import.
- Due right away: a subscription whose renewal date has passed renews right after import, by charging the saved card or emailing the invoice.
Check the Results
After importing each subscription, Stackless compares its status, currency, recurring total to the cent, renewal date when it’s still ahead and number of downloads with the EDD Recurring record. Any difference shows under Worth checking, with the result Imported.
Open a subscription with a difference from the link in the table and correct it on its edit screen. See Manage Subscriptions in the Admin.
Run Side by Side with EDD Recurring
Stackless Subscriptions runs beside EDD Recurring while this module is on. Once anything was imported, it keeps running even if you switch this module off, so imported subscriptions keep renewing.
- Downloads that still have EDD Recurring settings keep selling EDD Recurring subscriptions until you convert them.
- While subscriptions stay, the 3. Tidy up step says how many “stay on EDD Recurring and keep renewing there”, and to keep EDD Recurring active for them.
- When nothing is left, it says “No subscriptions are left on EDD Recurring.” Deactivate EDD Recurring under Plugins once you’re happy with the import, and keep its data as a record.
Convert Download Settings
With Download settings ticked, the downloads whose subscriptions were imported are converted when an import run finishes. The Tidy up step also counts downloads that still sell EDD Recurring subscriptions and offers Convert them to Stackless subscription plans, which works even with the setting off.
For a single-price download, or each recurring price option:
- The EDD Recurring period becomes the Stackless billing period.
- Times billed becomes Renewals, one less because EDD Recurring counts the first payment. 0 still renews until cancelled.
- The signup fee and free trial carry over.
- Renewal mode is set to “Automatic when the gateway supports it, otherwise manual”.
- EDD Recurring’s recurring switch is turned off. Its other values stay, and the original settings are kept in the
_stackless_edd_recurring_backuppost meta, so you can switch back.
Downloads that already have a Stackless plan are left alone, and a price option with a period Stackless can’t sell stays as it was. See Sell Downloads as Subscriptions for the plan fields.
Limits
- Only EDD Recurring Payments is imported.
- Subscriptions are cancelled at a provider only for Stripe and PayPal Commerce. If another gateway’s provider bills subscriptions on its own schedule, as PayPal Standard does, cancel moved ones there yourself, or set Other payment methods to Leave them on EDD Recurring.
- Stripe and PayPal moves need the Stackless gateway on the same account and in the same mode. On a site Stackless treats as a copy of the live store, cancelling at Stripe or PayPal is refused, so those moves fail there.
- A move with the saved card saves the card first, then cancels the Stripe subscription. If the cancellation fails, nothing is imported and EDD Recurring keeps billing, but the saved card stays in Stackless, unused.
- Every imported subscription, history included, is marked Cancelled in EDD Recurring by changing its record directly. EDD Recurring sends no email and runs none of its own cancellation steps. Newer EDD Recurring versions may not show the hand-over note.
- Failing subscriptions import as On hold with no retries scheduled. If an unpaid renewal order came over, the customer can pay it. Otherwise reactivate or cancel them yourself.
- EDD Recurring dates are read in your site’s time zone. Compare a few renewal dates with EDD Recurring’s after the scan, before you import.
- Guest subscriptions come over, but the customer can’t manage them from the account page.
For Developers
WP-CLI runs the same steps in the foreground, with the same checks:
wp stackless-edd recurring status
wp stackless-edd recurring scan
wp stackless-edd recurring import [--limit=<number>] [--retry-failed]
scan uses your saved choices, including Ended subscriptions. import needs no confirmation box but still refuses to run without Stackless Subscriptions. It converts downloads afterwards when Download settings is ticked. --retry-failed moves failed subscriptions back to To import first.
Other migrations can call stackless_edd_import_subscription(). It takes one record as an array and returns the new subscription ID or a WP_Error. The source key makes it safe to call twice: the second call returns the subscription made the first time. Dates are Unix timestamps. Without a token_id, it renews by pay link unless its gateway bills subscriptions itself. Nothing is charged and no email is sent. stackless_edd_subscription_imported fires after each one.
$id = stackless_edd_import_subscription([
'source' => 'legacy:1042',
'status' => 'active',
'customer_id' => 17,
'user_id' => 4,
'email' => 'buyer@example.com',
'currency' => 'USD',
'gateway' => 'manual',
'renewal_mode' => 'manual',
'period' => 'month',
'interval' => 1,
'times' => 0,
'dates' => [
'start' => strtotime('2026-01-05'),
'next_payment' => strtotime('2026-12-05'),
],
'items' => [
['download_id' => 55, 'price_id' => 1, 'quantity' => 1, 'amount' => 29, 'name' => 'Pro plan'],
],
]);
A record needs a source, a status, a day, week, month or year period, a three-letter currency, a valid email, at least one download and a start date. An active or trial one also needs a next payment or end date. The comment above the function in includes/functions.php lists the other keys. The Stripe and PayPal steps go through stackless_edd_adopt_external_subscription and stackless_edd_cancel_external_subscription. See Hooks and Functions.