WP-CLI Reference

For stores with thousands of orders, the WP-CLI is faster than the admin wizard and avoids browser timeouts entirely. The same engine drives both interfaces, so the result is identical — only the surface differs.

When to use WP-CLI

Use the CLI when:

• Your store has more than a few thousand orders.
• You are running on shared hosting with strict PHP timeouts.
• You want to script a migration as part of a deployment workflow.
• The browser keeps disconnecting mid-run on a large dataset.
• You are migrating on staging via SSH and don't have admin UI access.

The wizard remains the right choice for small-to-medium stores or for non-technical operators.

Commands at a glance

The wizard surfaces the most common commands inside the WP-CLI (Recommended for Large Stores) panel:

The primary command

All migration work happens through one namespaced command, with flags for each stage:

wp fluent_cart_migrator migrate_from_edd [flag]

Flag reference

Flag	What it does
--all	Run the complete migration pipeline: products → tax rates → coupons → payments → recount, in order. Resumes any skipped or interrupted steps.
--products	Migrate EDD downloads to FluentCart products. Creates new ones, updates existing ones via the migration ID map.
--tax_rates	Migrate EDD tax settings and generate FluentCart tax rates. Skipped automatically if taxes are disabled in EDD.
--coupons	Migrate EDD discount codes to FluentCart coupons. Updates by code if a match exists, otherwise inserts.
--payments	Migrate EDD orders, transactions, subscriptions, and licenses. Processed in batches of 1,000 orders per page, with last page persisted for resume.
--recount	Recalculate stats after migration: lifetime value, average order value, customer purchase counts, subscription bill counts, missing UUIDs.
--stats	Show pre-migration statistics for the source store. No data is migrated.
--verify_license	Compare EDD and FluentCart licenses after migration. Reports missing licenses and status mismatches.
--log	Display the failed payment log (_fluent_edd_failed_payment_logs).
--reset	Wipe migrated data and clear migration state. Requires Developer Mode. See Developer Mode & Reset.

Common workflows

Full migration in one command

wp fluent_cart_migrator migrate_from_edd --all

Runs every stage in order. If any stage was previously completed, it is skipped automatically. If the previous run was interrupted mid-payments, it resumes from the last processed page.

Step by step

For more control, run each stage individually. Useful when you want to inspect the result between stages or when one stage needs special handling.

wp fluent_cart_migrator migrate_from_edd --products
wp fluent_cart_migrator migrate_from_edd --tax_rates
wp fluent_cart_migrator migrate_from_edd --coupons
wp fluent_cart_migrator migrate_from_edd --payments
wp fluent_cart_migrator migrate_from_edd --recount

The order matters. Products must exist before payments can reference them. Recount should be the final stage.

Preview source data

Before migrating anything, see what is in the source store:

wp fluent_cart_migrator migrate_from_edd --stats

Shows the count of products, orders, transactions, customers, subscriptions, licenses, the gateways found, and the order statuses present. No data is touched.

Inspect failures after a run

If individual orders failed during the migration (corrupted records, missing customer references, malformed line items), they are captured rather than halting the whole run. View them with:

wp fluent_cart_migrator migrate_from_edd --log

Each entry shows the EDD order ID, the error message, the error type, and the stage at which it failed. Use this to drive a follow-up investigation.

Verify license integrity

After a migration that includes EDD Software Licensing, run:

wp fluent_cart_migrator migrate_from_edd --verify_license

This compares the EDD license records against the FluentCart license records and reports any that are missing or have status mismatches. Run this before deactivating EDD.

Companion commands

Beyond the main migrate_from_edd command, the Migrator provides utilities for cleanup and developer workflows:

Clean up EDD data after migration

Once you have validated the migration and are ready to remove EDD's artifacts from the database:

wp fluent_cart_migrator edd_cleanup

Deletes EDD post types (edd_advanced_report, edd_discount, edd_license_log, edd_log, edd_payment), orphaned post and comment metadata, and the download_category and edd_log_type taxonomies. Asks for confirmation before running.

Run cleanup only after full verification

Don't run edd_cleanup until you have verified the migration thoroughly and your customers, subscriptions, and licenses are operating correctly through FluentCart. The original EDD records are your fallback if something needs reconciliation.

Reset progress and refresh schema (developer)

wp fluent_cart_migrator migrate_fresh

Clears all migration progress options, refreshes the FluentCart database schema, deletes migrated FluentCart products, and removes migration metadata from EDD posts. Useful for testing on a staging environment when you want to rerun the full migration from scratch.

This command requires Developer Mode.

Reset migrated data (developer)

wp fluent_cart_migrator reset

Wipes migrated data and clears migration state. Slightly less aggressive than migrate_fresh — it does not refresh the schema. Asks for confirmation before running.

This command requires Developer Mode.

Backfill missing subscription UUIDs

wp fluent_cart_migrator fix_subs_uuid

Standalone utility that fills in missing UUIDs on subscription records. Subscriptions migrated from older EDD installations occasionally lack UUIDs; this backfills them with md5(id + uuid4 + microtime) so other parts of FluentCart can reference them reliably.

Resume behavior

The CLI is fully resumable. State is persisted in the __fluent_cart_edd3_migration_steps option after every completed step.

• Stage-level resume: Re-running --all skips any stages already marked complete.
• Page-level resume for payments: The payment migration stores last_order_page. A re-run continues from the next batch.
• Idempotent re-runs of individual stages: --products updates existing migrated products via the ID map. --coupons updates existing coupons by code. --recount always recalculates from current data, never increments.

This means you can safely interrupt a long run with Ctrl+C and start it again. No duplicate data, no skipped records.

Memory and timing tips

For very large stores, give PHP enough headroom:

php -d memory_limit=1024M $(which wp) fluent_cart_migrator migrate_from_edd --all

If the host has aggressive process limits, run individual stages rather than --all, so each invocation has its own memory context.

What the CLI doesn't do that the wizard does

• The CLI does not show a live, polling progress bar in the wizard's visual style. It uses WP-CLI's built-in progress bar for the payments stage.
• The CLI does not pause and resume mid-stage on demand — only between stages.
• The CLI does not surface the post-migration backward compatibility notice. Read Backward Compatibility directly to know what to keep enabled.

For everything else, the CLI is functionally equivalent to the wizard — and faster on real workloads.

Related

• Migrating from EDD — wizard walkthrough
• Developer Mode & Reset — reset workflow for staging
• Troubleshooting — what to do when something fails