Appearance
Migrating from Easy Digital Downloads
The FluentCart Migrator handles end-to-end migration from Easy Digital Downloads 3.x into FluentCart. Products, customers, orders across every meaningful status, recurring subscriptions, software licenses with all their site activations, coupons, and tax configuration transfer in a single coordinated pipeline.
The same engine is reachable two ways — pick the surface that fits your store size and comfort level:
- Admin Wizard — six-step Vue interface inside WordPress admin. Best for small to medium stores and non-technical operators.
- WP-CLI — single namespaced command with flags for each stage. Faster for large stores, no browser timeouts.
Your EDD store stays untouched
The Migrator only reads from EDD. Your existing store, its settings, and every record stay exactly as they are. Run both side-by-side until you're ready to switch.
Documentation in this section
| Page | When to read |
|---|---|
| Wizard Walkthrough | Start here. Full step-by-step run through the admin wizard, with screenshots. |
| What Gets Migrated | Before you start. Complete inventory of what transfers — and what's deliberately out of scope (categories, upgrade paths, gateway credentials, custom meta). |
| WP-CLI Reference | If your store has thousands of orders, or you prefer the terminal. Full flag reference and workflows. |
| Developer Mode | Before testing on staging. Explains the FLUENT_CART_DEV_MODE constant that gates destructive reset paths. |
| Backward Compatibility | After migration. Why the Migrator plugin must stay active — license API rerouting, PayPal IPN, Stripe webhook fallback, legacy URLs. |
| Troubleshooting | When something fails or you want to verify. Failed payment log, license verification, common errors, reset workflow, FAQ. |
Recommended workflow
- Take a database backup. Even though the Migrator never modifies your source data, a fresh backup is your safety net.
- Read What Gets Migrated. Confirm the boundaries match your expectations.
- Rehearse on staging first. Enable Developer Mode so you can reset and re-run as many times as needed.
- Verify the result. Spot-check products, orders, subscriptions, and licenses against your source store.
- Repeat on production. With staging validated, the production run is uneventful.
- Keep the Migrator plugin active. It provides a backward compatibility layer for legacy URLs, license API calls, and PayPal IPN renewals.
Quick requirements check
- Easy Digital Downloads 3.x with the v3 table schema (EDD 2.x CPT-based stores are blocked at the compatibility check)
- FluentCart installed and activated
- FluentCart Pro required only for EDD Software Licensing migration
- PHP memory limit of 256MB recommended for larger stores
- WP-CLI for command-line workflows
For full details, head to the Wizard Walkthrough.