Documentation

Install, configure, and run your Ecwid to WooCommerce migration.

These docs cover the complete Ecwid2Woo setup path: WordPress installation, Ecwid API credentials, sync mode selection, migration safety, and common troubleshooting steps.

InstallEcwid APISync ModesSafetyTroubleshootingSupport
Install

Install the plugin in WordPress.

Ecwid2Woo is a WordPress plugin. It runs in your own WordPress admin and writes catalog data into WooCommerce.

Step 1

Download the plugin

Go to the Ecwid2Woo download page and download the current ZIP file. Keep the ZIP intact for WordPress upload.

Step 2

Upload in WordPress

In WordPress, open Plugins > Add New > Upload Plugin. Select the Ecwid2Woo ZIP, install it, then activate it.

Step 3

Confirm WooCommerce is active

Ecwid2Woo runs inside WordPress and writes into WooCommerce. Activate WooCommerce before connecting Ecwid credentials.

Step 4

Open E2W Sync settings

In the WordPress admin, open E2W Sync > Settings. Enter your Ecwid Store ID and API token, save, and test the connection.

Ecwid API

Create credentials with read permissions.

Ecwid2Woo only needs read access to your Ecwid catalog and store profile. The token is stored in WordPress settings and used by your site during sync.

Where to find it

In Ecwid, open Apps > My Apps > API. Copy the Store ID and create an API token for the store you are migrating. Copy the generated token immediately because Ecwid may not show it again.

Required fields

Store ID from your Ecwid control panel
Ecwid REST API v3 token
Read catalog permission
Read store profile permission
Read products permission
Read categories permission
Sync Modes

Choose the right sync path.

Most first-time migrations should start with Full Sync. Use the individual modules for staged imports, updates, or troubleshooting.

Full Sync

Use this for a first migration. It imports categories first, then products, variations, images, stock, prices, SKUs, weight, and dimensions.

Category Sync

Use this when you need to build or repair the WooCommerce category hierarchy before importing products.

Product Sync

Use this for targeted product imports, product updates, or bulk product sync after categories are already in place.

Placeholders

Use this to review temporary category placeholders and sync metadata created while preserving category relationships.

Safety

How Ecwid2Woo protects long migrations.

The plugin is designed for interrupted, restarted, and low-resource migrations where retries are normal.

Smart Skip resumes interrupted migrations and skips products that are already current.
Self-healing batches reduce batch size after timeout or server errors, then recover after successful runs.
Existing WooCommerce products are matched by Ecwid ID first, then SKU, instead of blindly duplicating products.
Image preservation tracks imported image sources to avoid repeated downloads and duplicate media.
Stop Sync cancels long-running operations when you need to pause or investigate.
WP_DEBUG logging records API calls, skip decisions, retries, and batch progress for diagnostics.
Troubleshooting

Fix the common migration issues first.

Most failed starts come from token permissions, server limits, or running products before categories.

Connection test fails

1Confirm the Store ID is numeric and copied from the correct Ecwid store.
2Create a fresh API token with read access to catalog, products, categories, and store profile.
3Paste the token again and test before starting a sync.

HTTP 403 from Ecwid

1The token usually lacks a required read permission.
2Regenerate the token in Ecwid and select all required read scopes.
3Save the new token in E2W Sync settings.

Timeouts or 503 errors

1Run Category Sync first, then Product Sync.
2Run the migration during a low-traffic period.
3Let the adaptive batch system reduce load automatically before increasing server limits.

Products import into the wrong categories

1Run Category Sync before Product Sync.
2Use the hierarchy repair tools if categories were imported in an earlier failed run.
3Review placeholder categories after the sync finishes.
Support

When you need more help.

Use GitHub for public bugs and feature requests. Use the contact form when the details are private.

Contact SupportGitHub DiscussionsRead FAQ