Installation
Install and activate the CartShift plugin. Both WooCommerce and FluentCart must be active before the migrator will load.
Requirements
Before installing, make sure your site meets these requirements:
| Requirement | Details |
|---|---|
| WordPress | 6.4 or higher |
| PHP | 8.1 or higher |
| WooCommerce | Installed and active |
| FluentCart | Installed and active |
| WC Subscriptions | Optional — only needed if you want to migrate subscriptions |
| PHP Memory | 256 MB recommended (128 MB minimum) |
Both plugins must be active
CartShift requires both WooCommerce and FluentCart to be active at the same time. If either plugin is deactivated, the migrator will show an admin notice and will not load its migration interface or REST endpoints.
Install the Plugin
Download the plugin
Download the cartshift.zip from GitHub.
Upload to WordPress
Go to Plugins > Add New > Upload Plugin in your WordPress admin. Select the cartshift.zip file and click Install Now.
Alternatively, extract the zip and upload the cartshift folder to /wp-content/plugins/ via FTP or your hosting file manager.
Activate the plugin
Go to Plugins and click Activate on "CartShift".
On activation, the plugin creates two database tables:
wp_cartshift_id_map— Stores the mapping between WooCommerce IDs and FluentCart IDs for every migrated recordwp_cartshift_migration_log— Stores detailed log entries for every record processed during migration
These tables use your WordPress table prefix (shown as wp_ above).
Access the migrator
After activation, go to Tools > CartShift in the WordPress admin sidebar. This is where you will run preflight checks, start the migration, and monitor progress.
Verifying the Installation
After activation, confirm everything is working:
- Navigate to Tools > CartShift — you should see the migration interface
- If you see an error notice saying "CartShift requires WooCommerce and FluentCart to be active", check that both plugins are activated
- The preflight check will verify your environment in detail before you start any migration
Database tables
If you need to verify the tables were created, check your database for wp_cartshift_id_map and wp_cartshift_migration_log (with your actual table prefix). These are created using WordPress dbDelta() on activation and will not overwrite existing tables.
After Migration
CartShift is a one-time tool. Once you have completed and verified your migration:
- Go to Plugins and Deactivate "CartShift"
- You can safely delete the plugin — uninstalling will drop the
cartshift_id_mapandcartshift_migration_logtables and remove thecartshift_migration_stateoption - If you want to keep the migration log and ID map for reference, deactivate without deleting
Keep the plugin until you are sure
Do not uninstall (delete) the plugin until you have fully verified your migrated data in FluentCart. The ID mapping table and migration log are deleted on uninstall. If you need to rollback, you need the plugin active with its tables intact.
Next Steps
With the plugin installed and active, proceed to Preflight Checks to validate your environment before starting the migration.
CartShift Overview
WooCommerce to FluentCart migration tool. Products, customers, orders, subscriptions, and coupons — mapped and migrated with full ID tracking and rollback support.
Preflight Checks
Validate your environment before migration. The preflight system checks WooCommerce, FluentCart, PHP memory, WC Subscriptions availability, and existing FluentCart data.