Skip to main content
Platform Migration is in Settings, under Store, then Platform Migration. It brings a store you run on another platform across to this one, with that platform’s API key. You choose what comes across; nothing is changed on the other platform, and nothing already in this store is written over.

​
The platforms

What each platform’s API gives is different, and the table follows it: SellAuth names an order’s affiliate only when that one order is read by itself, SellApp names no affiliate’s code, and SellHub says neither which products a category holds nor any buyer’s balance.

​
Bringing a store across

  1. Press Import beside the platform.
  2. Paste an API key from that platform. Where to make one, and what to tick, is under the box. Only read permissions are needed; where a platform has no read-only keys, Shoply still only reads with it, and you can delete the key once the import is done.
  3. Press Check Key. The key is checked with the platform before anything starts, and the dialog says whose store it reaches. A key that reaches several stores asks which one, under Which Store. For SellApp, type the store’s handle as well, as it is in your store’s address.
  4. What Was Found lists how much of each kind is there, each with a switch. Unsold Keys come with Products: switching products off switches them off too.
  5. Under Reviews, Star Ratings to Bring has a tick for each rating, all five ticked to start. Untick the ones you do not want, for example to bring five-star reviews only.
  6. Press Start Import.
The dialog says about how long the import will take before it starts. Shoply reads the other platform slowly on purpose, about one request every two seconds, so that it never presses that platform’s limits: a small store takes a few minutes, and a large one can take an hour or more. Where a platform says it has few requests left, Shoply waits for its limit to reset, and if a platform asks it to slow down, it reads more slowly for the rest of that import. The import runs by itself, and you can close Settings while it does. Its card at the top of Platform Migration shows how far each kind has got and about how long is left, and you are emailed when it is done. One import runs at a time across all your stores, and an Undo counts as one: while one is running on another of your stores, Platform Migration says which, and you can import once it ends. Stop Import stops it; what came across so far stays, and can be undone.

​
What comes across, and how

Files and dynamic delivery don’t come across. No platform’s API hands over a file itself, and Shoply calls your own server in its own way, not the other platform’s. A product that delivered a file or from your own server there arrives without it, and the card names each one: add its files, or set up its delivery, before you show it. What does not fit is passed over, and the card says so: a store holds 250 products, 150 categories and 500 affiliates, a product 100 variants and 10 pictures, a variant 5,000 unsold keys. A free price becomes 0.01, the lowest a price can be, and the card says to check it. An affiliate whose code is taken here already, or who has none (every SellApp affiliate), is given a new one, and the card says to tell them their new link. Where the platform does not say what an affiliate earns, they earn your store’s default commission. A commission or a discount over 90% is brought across as 90%. An import never switches your affiliate programme on. If it is off, the dialog says so under Affiliates before you start, and the card says it again at the end: until you switch it on in Settings, Affiliates, their links take nothing off and earn nothing, and they cannot ask for a payout or spend their balance. Switch it on once your store on the other platform is closed, so that nobody is paid twice.
The other platform keeps its copy of everything. Once you are happy with the import, close your store there: its unsold keys, its buyers’ balances and its affiliates’ balances are still there, and could otherwise be used twice.

​
Undo

Undo Import takes away what that import brought across: its products, categories, orders and reviews, the customers and affiliates it made, and the balances it added. Anything sold, changed or bought here since stays:
  • a product that was sold, changed, or put in an upsell, a coupon, a sale or a subscription plan stays, with its keys;
  • a category you changed, or that still holds a product that stays, stays;
  • a balance is taken back as far as it is still there: what a buyer spent was a sale, and what an affiliate was paid or moved to their store balance is theirs;
  • a buyer who has ordered here, has a ticket, a subscription, a tag or an affiliate link, stays;
  • an affiliate who has earned here, been paid, had their link used or been changed since, stays.
Bringing the same store across again later makes nothing twice: what is already here is passed over.

​
Safety

  • Shoply only ever reads from the other platform, and only the lists it needs. The reads go through a service of Shoply’s own that sends nothing but reads, to those platforms’ APIs and nowhere else.
  • The key is kept encrypted while the import runs, and forgotten as soon as it ends, however it ends. It is never shown again.
  • Checking keys and starting imports have limits of their own: 20 checks in ten minutes, and 2 imports an hour, for a store.