Your First Migration

Quick Start Guide

Step 1: Connect

  1. Enter your source store URL and connector token
  2. Click Test Connection to verify
  3. The module automatically detects the source PrestaShop version

Step 2: Map Entities

The module fetches your source store's shops, languages, currencies, and order states. Map each source entity to its target equivalent:

  • Shops — Which source shop maps to which target shop
  • Languages — Match source languages to target languages
  • Currencies — Map source currencies to target currencies
  • Order States — Match order statuses between stores

Step 3: Choose a Migration Profile

Select a pre-built profile to quickly configure which entities to migrate:

  • Full Clone — Replicate the entire store including infrastructure (shops, languages, currencies, order states, groups) and all data
  • Full Store — Migrate all data entities without infrastructure
  • Product Catalog — Products with categories, taxes, manufacturers, and suppliers
  • Customers — Customer accounts with optional cart rules
  • Orders — Order history with required dependencies (customers, products, etc.)
  • CMS — CMS pages and categories only
  • Custom — Manually select individual entity types

Step 4: Set Import Options

Configure how the migration should behave:

  • Keep IDs — Preserve source entity IDs in the target
  • Clear Data — Remove existing target data before import
  • Migrate Image Files — Download images from the source store
  • Backup Database — Create a DB backup before starting
  • Backup Images — Backup target images before starting

Step 5: Start Migration

Click Start Migration and monitor real-time progress for each entity type. The migration processes entities in dependency order with configurable batch sizes.

Step 6: Review Report

After completion, review the migration report with:

  • Total entities imported per type
  • Error counts and details
  • Exportable CSV logs