> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating to Komerza

> Import your products, orders and customers from another platform

Komerza can import your store data from another platform in one guided step. The migration tool currently supports **Sellhub** and **Sellpass**. Coming from anywhere else - SellAuth, Paylix, Sell.sn or another platform - contact support and we will advise on the best path.

## What imports

| Platform     | Imports                              | Notes                                  |
| ------------ | ------------------------------------ | -------------------------------------- |
| **Sellhub**  | Products, reviews, orders, customers | Single store                           |
| **Sellpass** | Products                             | Multi-store: you pick the source store |

**Not migrated from any platform:** coupons, payment gateway configuration, custom domains, balances and funds, and subscriptions. Plan to set those up on Komerza after the import.

<Warning>
  **Check your plan limit before you run the migration.** An import stops at
  your plan's product limit and the extras are **silently skipped** - Free
  allows 15 products, Premium 1,000, Business unlimited. This is the most common
  cause of "products are missing after my migration".
</Warning>

## Before you start

If you are new to Komerza, create your account at [dashboard.komerza.com](https://dashboard.komerza.com) - signing up creates your account and your first store together, on a free `yourstore.mykomerza.com` URL. Confirm your email, and your account starts on the Free plan.

Already have an account? You don't need another one. Add a store from the sidebar store selector → **Create New Store**, within your plan's store limit.

## Running the migration

<Steps>
  <Step title="Open the Migration tab">
    In the dashboard, open the store selector → **Store settings → Migration**
    ("Import your store data from another platform").
  </Step>

  <Step title="Pick the platform and paste your key">
    Select the source platform and paste that platform's API or authorization
    key. The key is used for the import and is not stored permanently.
  </Step>

  <Step title="Choose the source store">
    For multi-store platforms such as Sellpass, pick which store to import from.
  </Step>

  <Step title="Start the migration">
    Click **Start Migration**. The import runs in the background - allow up to
    about two hours. You will receive a "Migration completed" email with counts
    of what was imported, or a "Migration failed" email.
  </Step>
</Steps>

## How conflicts are handled

* **Duplicate product slugs** are de-duplicated with `-2`, `-3` suffixes.
* **Customers with the same email address** are merged into one customer record.

## If the migration fails

A failure is almost always the source platform rejecting the key. You will see the platform's own reason where available, or a message like "Unable to get stores from the platform, check your authorization key or try again later".

The fix is nearly always the same: **generate a brand-new API key on the source platform and run the migration again.** Keys copied from old emails or notes are frequently expired or revoked.

## After the import

Migration brings your catalogue; it does not bring your storefront or your ability to take money. Work through these:

<CardGroup cols={2}>
  <Card title="Check your products" icon="box" href="/guides/products-and-variants">
    Confirm counts, then check delivery items and stock modes on each variant.
  </Card>

  <Card title="Connect payment methods" icon="credit-card" href="/guides/payment-methods">
    Gateway configuration never migrates. Nothing sells until this is done.
  </Card>

  <Card title="Build your storefront" icon="palette" href="/guides/embed-sdk">
    Use the builder, or embed checkout in a site you already have.
  </Card>

  <Card title="Connect your domain" icon="globe" href="/guides/custom-domain">
    Requires the Premium plan or above.
  </Card>
</CardGroup>

## When to contact support

* A freshly generated, valid API key from the source platform still fails.
* Imported counts look wrong even after accounting for your plan's product limit.
* You are migrating from a platform that isn't listed.
* You need data the tool doesn't cover for your platform, such as orders or customers from Sellpass, or coupons and subscriptions from anywhere.