WooCommerce
Use this when your source store runs WooCommerce on WordPress. Graftport reads from the WooCommerce REST API — no plugin installs, no FTP access, and no WordPress admin login required.
Credentials
| Field | Example | Notes |
|---|---|---|
| WordPress site URL | https://example.com | Full URL including https://. No trailing slash. |
| Consumer key | ck_abc123… | Generated in WooCommerce → Settings → Advanced → REST API. |
| Consumer secret | cs_abc123… | Generated alongside the consumer key. |
Creating a WooCommerce REST API key
- In your WordPress admin, go to WooCommerce → Settings → Advanced → REST API.
- Click Add key.
- Set Description to something recognisable (e.g.
Graftport migration). - Set User to any admin user.
- Set Permissions to Read.
- Click Generate API key.
- Copy the Consumer key and Consumer secret — they are shown only once.
The consumer secret is shown only once at creation time. Copy it immediately.
What is migrated
| Resource | WooCommerce source | Notes |
|---|---|---|
| Products | Simple and variable products | Variations become Shopify variants |
| Collections | Product categories | Hierarchy preserved as nested collections |
| Customers | WooCommerce customer accounts | WordPress-only users (editors, admins) are not migrated |
| Orders | All orders | Line items, shipping lines, and payment status |
Required permissions
The REST API key needs Read permission only. Write access is not required and should not be granted.
Quirks
Variable products and variations. WooCommerce stores variable products and their variations separately. Graftport fetches each variation set automatically during extract — no manual work needed. Each variation becomes a Shopify variant with the matching option values.
WordPress users vs. customers. WooCommerce stores every customer as a
WordPress user with the customer role. Graftport migrates accounts with that
role only. WordPress editors, administrators, and other roles are skipped.
Marketing consent. The WooCommerce REST API does not expose newsletter subscription status. Migrated customers are created with email marketing consent set to off. Re-subscription can be managed via a Shopify email marketing app after migration.
Product category URLs. The default WooCommerce URL for a product category
is /product-category/{slug}/. If your store uses custom permalink settings,
review the generated 301 redirects before launching.