Wix migration
@mercentia/wix-migrator pulls catalogue and order data from
Wix Stores via the
Wix Stores REST API.
What’s migrated
| Entity | Notes |
|---|---|
| Products + variants | Wix productOptions are mapped to Mercentia option types |
| Product images | Re-hosted on Mercentia’s CDN |
| Collections | Including manual collections and dynamic queries (the query is preserved as a metafield) |
| Customers | Wix Contacts with a “Store” label |
| Orders | With line items, fulfillment status, and Wix Payments references |
| Coupons | Imported as discount codes |
Setup
In Wix:
- Go to Wix Dev Center and create a Headless Site project against your live site.
- Add the Wix Stores scope and approve.
- Copy the API Key from your project’s Tokens panel.
In Mercentia:
- Settings → Migration → Wix.
- Paste the API key and your Wix site id (visible in your Wix dashboard URL).
- Toggle which entities to import.
- Click Start migration.
Limitations
- Wix doesn’t expose draft/unpublished products through the public REST API, so only published items are migrated. Re-run after publishing the rest.
- Wix Bookings / Restaurants / Events products are skipped — the migrator only handles physical and digital products in Wix Stores.
- Order refunds aren’t queryable via API in Wix; the migrator ports the gross order and flags refunded orders for manual review in Mercentia.
Verification
After import, the dashboard offers a Reconcile action that spot-checks 50 random Wix products and compares price + stock against the imported Mercentia rows. Mismatches surface in the migration job log.