--- title: "HikaShop Migration Adapter" description: "Move a HikaShop 5.x or 6.x store into J2Commerce 6 with the HikaShop adapter for J2Commerce Migrator." url: "https://docs.j2commerce.com/v6/migration-tools/hikashop" markdown_url: "https://docs.j2commerce.com/v6/migration-tools/hikashop.md" last_updated: "2026-11-01T16:22:04+00:00" version: "J2Commerce 6" breadcrumbs: - title: "Home" url: "https://docs.j2commerce.com/" - title: "J2Commerce 6" url: "https://docs.j2commerce.com/v6" - title: "Migration Tools" url: "https://docs.j2commerce.com/v6/migration-tools" - title: "HikaShop Migration Adapter" url: "https://docs.j2commerce.com/v6/migration-tools/hikashop" --- # HikaShop Migration Adapter The HikaShop Migration Adapter is the source connector for the [J2Commerce Migrator](https://docs.j2commerce.com/index.php?option=com_content&view=article&id=592&catid=54). It moves a HikaShop store into J2Commerce 6: catalog, customers, orders, coupons, shipping methods and more. Your HikaShop tables are read, never changed. It is for store owners switching from HikaShop 5.x or 6.x to J2Commerce. ## Requirements - PHP 8.3 or later - Joomla 6.0 or later - J2Commerce 6.0.0 or later, installed and enabled - J2Commerce Migrator 6.1.10 or later, installed and enabled - HikaShop 5.x or 6.x, installed and enabled, with products in its product table - A writable `images` folder. Images are copied to `images/j2commerce/`. > **Tip:** Run the migration on a staging copy of your site first. Check the products, orders and customers there before you migrate the live store. ## Get the Adapter The HikaShop adapter is a separate add-on available from the [J2Commerce Extensions Store](https://www.j2commerce.com/extensions). It does not ship with J2Commerce 6. ## Install the Adapter 1. Update J2Commerce Migrator to 6.1.10 or later. 2. Go to **System** -> **Install** -> **Extensions** and upload the adapter zip. 3. Open **Components** -> **J2Commerce Migrator** and confirm the HikaShop adapter is enabled in the adapter list. Only one migrator adapter can be enabled at a time, so finish any running migration and disable the other adapter first. ## Open the Migration Wizard On the J2Commerce Migrator dashboard, click **Start Migration** on the HikaShop card. ![J2Commerce Migrator dashboard cards showing the Migrator and J2Commerce versions, Akeeba Backup status, and the HikaShop card with its Start Migration button](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/dashboard-start-migration.webp) The Migration Wizard shows the connection status, one progress card per section, and the buttons that run the migration. Click **Configure Connection** to set where the HikaShop tables are: this site's database, another database on the same server, or a remote server. ![Migration Wizard with Configure Connection, Rows Per Batch, Refresh Now, Dry-Run All and Run All Migrations above a connected status bar and progress cards for sections A to H](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/migration-wizard.webp) | Control | What It Does | | --- | --- | | **Rows Per Batch** | Sets how many rows each request processes: 500, 1000, 2000 or 5000. Lower it if requests time out. | | **Dry-Run All** | Previews the whole migration without writing data. | | **Run All Migrations** | Runs every section in order. | | **Sync All** | Runs every step in one section. | | **Re-Sync** | Runs one step again. | If J2Commerce already holds data, the wizard shows **This site already contains store data** and lists the affected tables. Review the list and click **I Understand, Allow Runs** to continue. ## What Gets Migrated The steps are grouped into eight sections. A section unlocks once the sections it depends on are synced. | Section | Steps | | --- | --- | | **A: Foundations** | Sync Currencies, Sync Countries & Zones, Sync Geozones & Tax, Sync Order Statuses, Sync Address Custom Fields, Sync Product Filters, Order Status Mapping, Tax Category Mapping | | **B: Catalog Setup** | Sync Manufacturers, Sync Product Categories, Sync Product Options | | **C: Products** | Sync Products, Sync Variants, Sync Product Prices, Sync Product Images, Sync Related Products, Sync Downloadable Files, Category Tags | | **D: Promotions & Logistics** | Sync Coupons, Payment Methods Checklist, Sync Shipping Methods, Payment Method Mapping, Shipping Method Mapping | | **E: Customers** | Sync Users, Sync Addresses | | **F: Orders** | Sync Orders, Sync Order Infos, Sync Order Items, Sync Order Breakdown, Sync Order Histories | | **G: Customer Activity** | Sync Carts (optional), Sync Reviews (optional) | | **H: Finalize** | Apply Component Config Patches, Multilingual Flatten (runs only when the store has multilingual data) | Open a section to see its steps. Each step shows its row count, status and **Re-Sync** button. ![Foundations section opened, with Sync Currencies, Sync Countries and Zones, and Sync Geozones and Tax rows showing row counts, a Synced status and Re-Sync buttons](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/foundations-section.webp) ### What Is Not Migrated - Automatic discounts without a coupon code. Recreate them as J2Commerce sale prices. - Payment methods. The **Payment Methods Checklist** lists each one with its settings so you can set up the matching J2Commerce plugin. - Affiliate and partner data on users and orders. - Guest baskets. They cannot be resumed in J2Commerce, so only baskets of registered customers are migrated. - Reviews, unless Product Reviews is installed. Get it from [J2Commerce Product Reviews](https://www.j2commerce.com/extensions), then run **Sync Reviews**. ## Mapping Screens Four mapping steps set where HikaShop values go. Click **Sync** or **Re-Sync** on a mapping step to open its screen. | Mapping | Section | Maps | To | | --- | --- | --- | --- | | **Order Status Mapping** | Foundations | HikaShop order statuses | J2Commerce order statuses | | **Tax Category Mapping** | Foundations | HikaShop tax categories | J2Commerce tax profiles | | **Payment Method Mapping** | Promotions & Logistics | Payment labels on orders | Installed J2Commerce payment plugins | | **Shipping Method Mapping** | Promotions & Logistics | Shipping labels on orders | Installed J2Commerce shipping plugins | Choose a value for each row and click **Save Mapping**. Saving also updates orders that were already migrated. ![Order Status Mapping screen listing each HikaShop status, its order count and a J2Commerce status dropdown, with Cancel and Save Mapping buttons](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/order-status-mapping.webp) A payment or shipping label left unmapped keeps its HikaShop text. ![Shipping Method Mapping screen listing three HikaShop shipping labels with their order counts and a J2Commerce shipping plugin dropdown on each row](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/shipping-method-mapping.webp) When you run **Sync All** or **Run All Migrations**, the mapping screens open one after another. The sync continues in the background while you review them. ## Step-by-Step Migration 1. Back up your site and database. **Backup Now** is in the wizard toolbar. 2. Click **Start Migration** on the HikaShop card and confirm the connection. 3. Click **Dry-Run All** and read the results. 4. Click **Run All Migrations**, or click **Sync All** on each section from A to H. 5. Choose values on each mapping screen and save. 6. Check products, customers and orders in J2Commerce. ### How Data Is Stored - Product, category and manufacturer images are copied to `images/j2commerce/`, a public folder. Each migrated category gets its image from the HikaShop category image. - Images that HikaShop saved with only a file name get the product title as alt text. - Order lines are stored as quantity x price, the same as orders placed in J2Commerce. - HikaShop states are matched to existing J2Commerce zones by name as well as by code. - Migrated orders show the store's shipping method and service name. ## Conflict Mode and Run Options Open the three-dot menu on a step to choose how it treats records that already exist. ![Step menu open on Sync Currencies, listing the conflict modes Skip, Overwrite, Merge and Preview, and the run options Dry-Run, Diagnose and Reset](https://docs.j2commerce.com/images/docs/v6/migration-tools/hikashop/conflict-mode-menu.webp) | Option | What It Does | | --- | --- | | **Skip** | Links the HikaShop row to the existing row. | | **Overwrite** | Replaces the existing row. | | **Merge** | Fills in the existing row. | | **Preview (No Writes)** | Reports what would change and writes nothing. | | **Dry-Run** | Previews this one step. | | **Diagnose** | Checks this one step for problems. | | **Reset** | Clears this step's status so it can run again. | ## After an Earlier Run If you ran an adapter version older than 6.0.7, set **Sync Order Items** and **Sync Product Images** to **Overwrite** and run them again. This replaces the old order lines and image records with the corrected ones. ## Troubleshooting ### The Adapter Will Not Install **Cause:** J2Commerce Migrator is older than 6.1.10, or is not installed. **Solution:** Update J2Commerce Migrator, then install the adapter again. ### Image Directory Is Not Writable **Cause:** The server does not let Joomla write to `images/j2commerce/`, or to `images` when the folder does not exist yet. **Solution:** Fix the folder permissions, then run **Sync Product Images** again. ### An Order or Address Says the User Has Not Been Migrated **Solution:** Run **Sync Users**, then run **Sync Addresses** or **Sync Orders** again. ### An Order Has No Matching Status **Cause:** Its HikaShop status has no J2Commerce equivalent. **Solution:** Open **Order Status Mapping**, choose a status for each row still set to **Choose**, and save.