Gatemi Store Migration Settings

Both editions have one screen: WooCommerce → Store Migration. It needs the manage_woocommerce capability.

There is almost nothing to configure, on purpose. A migration is something a shop does two or three times, so the screen asks for a file and two decisions.

The Store Migration screen
The whole screen: start a migration, then how imports behave.

Three things worth knowing

The top card explains the plugin's rules in a sentence each: nobody is emailed while a migration runs, running the same file twice changes nothing, and (free edition) the file is read in resumable batches / (full edition) an imported order keeps its own money. See How it works.

Start a migration

Shown when no migration is open.

Field Choices What it does
The file came from Shopify CSV export, WooCommerce CSV export Which column map is used to read the file.
And holds Products, Customers; Full edition: also Orders, Coupons What kind of record each row is. A file holds one kind.
The CSV a .csv file The upload.

Press Start. The file is stored under a random name in wp-content/uploads/gmsm-imports/ (full edition) or wp-content/uploads/gmsmf-imports/ (free edition), behind an index.html and a .htaccess that denies web access.

Only one migration is open at a time. To start another, finish the current one first.

The progress card

Shown while a migration is open, and after it finishes.

  • The file's name and a progress bar — how far through the file, by bytes read.
  • created, updated, skipped — counts of rows.
  • Why rows were skipped — each reason with how many rows it covered (up to 50 different reasons are kept).
  • While running: Run the next batch now — imports the next 50 rows immediately. Use it when WP-Cron is not running on your host.
  • When finished: Done — clear this and start another — closes the job. With Delete the uploaded file… on, the file is deleted too.

How imports behave

Both settings live in one option, gmsm_settings, shared by both editions.

Label Key Default What it does
Publish imported products straight away publish no When on, a product the old shop had published is created as published. When off, every imported product is a draft. A product the old shop had hidden is a draft either way.
Delete the uploaded file when I am done with a migration tidy_file yes When on, pressing Done — clear this and start another deletes the uploaded CSV. When off, the file is left in the uploads folder (the job is still cleared).

Press Save changes to keep them. Changing Publish… affects rows imported from then on; products already imported keep their status until they are imported again.

For developers — Full edition

The full edition's screen ends with a list of every filter it applies. They are described in the Developer reference.

License & updates — Full edition

The last card holds the licence key field (Activate), the licence status, the number of sites in use, a link to manage the licence on gatemi.com and Deactivate on this site. A network failure while checking never changes the licence's state.

The full edition — Free edition only

The free edition's screen has a card describing what Gatemi Store Migration for WooCommerce adds — orders and coupons — with a link to the full edition.

Shopping Cart
Scroll to Top