Start here

What this tool does

Think of this as a guided move of your store data. The tool connects to WooCommerce using either a direct database connection (MySQL or MariaDB) or the WooCommerce REST API (consumer key and secret), then creates matching records in Shopify — products, customers, orders, images, and more.

It never writes back to WooCommerce, and it doesn’t convert themes or storefront design.

01Connect WooCommerce

02Analyze store

03Link Shopify

04Review plan

05Run migration

06Validate & go live

Need a do-over? You can roll back selected Shopify data, or use Shopify cleanup to clear a staging store before trying again.

Two ways in

Admin console and merchant app

Admin console

For your platform team. Sign in with email and password to run and support migrations across shops.

Merchant app

For the shop owner. Open it from Shopify Admin → Apps so it stays tied to that store.

Both share the same day-to-day screens: wizard, dashboard, reports, rollback, and cleanup. Users, email queue, logs, maintenance, and settings stay in the admin console only.

Admin access

Sign in

Open the admin login page, enter your email and password, then tap Sign in.

You’ll land on the Dashboard after a successful sign-in.

Shopify side

Opening the merchant app

Always open the merchant experience from Shopify Admin. If you visit the app URL in a normal browser without an install session, you’ll see this screen instead:

Stay on top of jobs

Dashboard

This is your home base while a migration is running. Cards and job lists refresh live when the connection badge shows you’re online.

• See what’s active, finished, or failed
• Confirm workers look healthy
• Open a job, copy its ID, or dig into a failure reason
• Watch cleanup and rollback tasks in the same place
• Paste a migration ID to load one job’s live progress

Step by step

Migration wizard

The wizard walks you through the move in six short steps:

1. 1
   Connect WooCommerce — database or API, then pictures source
2. 2
   Analysis — what we found in your store
3. 3
   Shopify — confirm the destination shop
4. 4
   Plan — review what will move
5. 5
   Migration options — pick entities and policies
6. 6
   Start — kick off the background job

Connect WooCommerce

Give the job a clear name, optionally enable Dry-run mode (recommended for the first pass — the pipeline runs without writing to Shopify), then choose how we reach WooCommerce:

Switching methods keeps the fields you already entered for each mode.

Database connection

Fill in how we reach your database:

Click Test database connection and wait for a success message before moving on.

API connection

Choose API connection, then enter the store URL and REST keys from WooCommerce → Settings → Advanced → REST API (Read permission is enough). Prefer Auto-detect for API version unless you know you need a specific namespace.

Click Test API connection. A success banner shows the detected WooCommerce REST version.

Pictures source

Product galleries and media-library files share WordPress wp-content/uploads. Configure Pictures source after the connection test:

Click Test pictures source when product images are selected — the wizard requires a successful pictures test before you can continue from Migration options. Content (pages/blog) can still proceed with a warning if binaries cannot upload.

Analysis through Start

Once it starts, you can close the browser. Workers keep going in the background. Pause, resume, or cancel from the job actions when those controls are available. After a dry-run, approve go-live from the Dashboard when you are ready to write to Shopify.

Check the results

Validation reports

When you want proof the numbers look right, open Validation reports. Compare WooCommerce vs Shopify and export a spreadsheet for review or go-live sign-off.

Pick a migration here, or open one from the Dashboard with Open.

Undo on Shopify

Rollback

Rollback removes selected migrated data from Shopify only. Your WooCommerce store stays untouched.

Choose the migration and entities, then start. You’ll also see progress under Rollback tasks on the Dashboard.

Clear a store

Shopify cleanup

Cleanup permanently deletes selected resources from Shopify. It’s meant for staging resets or a clean re-run. Prefer a preset when you’re unsure — deletes follow a safe order.

Double-check the shop domain before you start. Cleanup can’t be undone from WooCommerce.

Past runs stay in cleanup history so you have an audit trail:

Admin tools

Admin console pages

Users

Invite teammates, search by email, and manage roles. Admins can temporarily work as a merchant and end that session from the top bar.

Email queue

See which alert emails were queued or sent — handy when you’re checking whether a failure notice went out.

Logs

When a job stalls, open Logs and look at the recent worker messages for that task.

Maintenance

Housekeeping tools such as purging old logs. Use these only when you mean to — they affect shared platform data.

Settings

Tune feature flags, workers, Shopify app credentials, WooCommerce defaults, and related options. After changing credentials or allowed origins, restart the host so the new values load.