---
title: "Eshop Migrator Adapter"
description: "The Eshop adapter adds JoomDonation EShop 4.x and 5.x as a source in J2Commerce Migrator. It moves products, orders, customers and related store data into J2Commerce 6. Use it when you are moving a…"
url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/eshop"
markdown_url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/eshop.md"
last_updated: "2026-11-12T16:16:50+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Apps and Extensions"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions"
  - title: "Plugins"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins"
  - title: "Eshop Migrator Adapter"
    url: "https://docs.j2commerce.com/v6/apps-and-extensions/plugins/eshop"
---

# Eshop Migrator Adapter

The Eshop adapter adds JoomDonation EShop 4.x and 5.x as a source in J2Commerce Migrator. It moves products, orders, customers and related store data into J2Commerce 6.

Use it when you are moving a store from EShop to J2Commerce, on the same server or from a remote database.

## Requirements

- J2Commerce 6.0.0 or later.
- The J2Commerce Migrator component, version 6.1.10 or later, installed and enabled.
- PHP 8.3 or later.
- PHP `memory_limit` of 256 MB or more for large catalogs.
- EShop 4.x or 5.x, either installed on this Joomla site or reachable as a remote database.
- The J2Commerce App Reviews plugin, only if you want to migrate reviews.

---

## Installation

1. Update J2Commerce Migrator to 6.1.10 or later.
2. In Joomla, go to **System** -> **Install** -> **Extensions**.
3. Upload the Eshop adapter package.

The plugin is enabled automatically on a new install. The Eshop card then appears on the Migrator dashboard.

---

## Settings

The plugin has no settings of its own. Connection details are set in the Migrator component: use the **Configure Connection** button on the Eshop card.

---

## Running a Migration

The dashboard card shows one of these states: Not installed, Installed but disabled, or Ready to migrate. With a remote source it shows that an EShop source was detected on the remote database.

1. Open the J2Commerce Migrator dashboard.
2. On the Eshop card, click **Configure Connection** if the source is a remote database.
3. Click **Start Migration**.

The migration covers these groups: Lookups, Tax & Geozones, Catalog Foundation, Products, Customers, Promotions, Orders and Reviews. EShop store settings, categories, tags and plugin configurations are also migrated.

### Post-Sync Tools

The Tools page has these groups. Post-sync passes run automatically after the product sync and can be re-run.

| Tool | What It Does |
| --- | --- |
| Sync Tax Classes, Sync Master Variants, Migrate Product Images, Audit Product Options | Runs individual post-migration passes. |
| Link Product Articles | Creates and links Joomla articles for migrated products that have no product source article. |
| Sync Products | Re-runs the product sync in strict order: categories, articles, then products, per batch. |
| Repair Content | Repairs migrated articles with empty JSON columns and rebuilds the category tree. |
| Rebuild Product Images | Re-copies and re-links product images from EShop into the J2Commerce image folders. |

---

## What Is Not Migrated

- Customer groups and tax customer groups.
- Catalog discounts: use J2Commerce coupons or special prices.
- Product labels, product Q&A, wishlists and quote/RFQ records.
- Postcode-range geozone rules: J2Commerce supports country and zone rules only.
- Secondary-language records.
- EShop plugins with no J2Commerce equivalent.

---

## Troubleshooting

- **"This plugin needs J2Commerce Migrator 6.1.10 or later."** Update the component, then install the plugin again.
- **EShop (com_eshop) was not found.** Migrate from a remote database instead, using the connection settings.
- **Reviews are skipped.** Install the J2Commerce App Reviews plugin and run the migration again.
- **Category paths look wrong.** Run Joomla **Rebuild Category Paths**, or use **Repair Content**.
- **Products have no articles or images.** Run **Link Product Articles** or **Rebuild Product Images**.

---

## Uninstalling

Uninstall the plugin from **System** -> **Manage** -> **Extensions**. Data already migrated stays in J2Commerce.