Guide for switching to Shopify Markets

Move from the old Shopify importer to Shopify Markets with the required setup steps.

Moving to Shopify Markets requires recreating any projects currently using your old Shopify importer. We recommend dedicating 2-3 hours, depending on your number of channels and/or projects.

Shopify Markets is an upgraded version of Shopify that makes it easier to scale your business and sell to multiple markets from a single store.

Our new Channable Shopify Markets importer is built for this new structure, offering significantly faster import times and simplified multi-market data management.

This guide is designed to help you transition from our old Shopify importer to Shopify Markets.

Why switch to Shopify Markets?

Shopify Markets offers significant benefits, including:

• Drastically faster import times
• Multi-market data and translations
• Simpler setup (since essential data is included by default

---

Before you start

You’ll need

• Shopify Markets enabled in your Shopify webshop
• Shopify Markets permission enabled for your Shopify connection in Channable

Good to know

• Draft items are currently not supported for Shopify Markets.
• You need to recreate your old setups to use Shopify Markets. The old Shopify importer stored translations and market data differently.

  • E.g. fields like title and price are now market-specific (e.g title_fr, price_netherlands)
  • Items with the Draft or Archived status are no longer imported and should be converted to Unlisted if possible.
• Setting up a new project ensures your rules and mappings reference the correct fields.

Old vs new importer differences

The old importer placed translated content into the default field (title, description). The new importer creates specific fields for localized data.

Data Type	Old Shopify behavior	New Shopify markets field name(s)
Product Translation	Translated content was placed in the default field (e.g. title).	title_{language_code} (e.g., title_fr, description_es)
Market Price	Only one default price field (e.g. price) was available.	price_{market_name} (e.g., price_netherlands, price_belgium) and the corresponding currency field (price_{market_name}_currency).
Inventory Quantity	Total in inventory_quantity. Stock per location was optional.	inventory_quantity (total) and quantity_{location_name} for each location.
Product Category	Limited category data.	product_category (e.g., "Dog Food") and product_category_path (full path).

Use two screens or a large monitor to compare your old and new setups as you work.

1

Create a new project

Modern version

1. In your Channable account, go to All projects.
2. Click Add project.

Legacy version

1. In your Channable account, go to Projects.
2. Click Create Project.

1. Give your project a descriptive name (e.g. ‘Shopify Markets change’).
2. Click Save.

2

Set up your Shopify Markets import

You’ll notice fewer settings are available. For Shopify Markets, essential data (like stock, location and collections) are included by default, simplifying your setup.

1. On the Getting started page, click + Add import.
2. Select Shopify Markets from the list of available imports.
3. Select your existing Shopify connection, or create a new one.

   1. New connection: Click Connect with Shopify. You will be redirected to Shopify to link your account and accept required permissions.
   2. Existing connection: Check you have Shopify Market permissions enabled for the connection.
4. Name: give your importer a clear name (e.g. ‘Shopify Markets’).
5. Choose language: Select any additional language(s) you want to import. The primary language is always included.
6. Click Start import.

3

Set your advanced settings (optional)

After we read your product data, you’ll land on the Edit mapping page.

If you would like to further customize your Shopify setup (e.g. import metafields, only import active markets):

1. Click on the Settings tab to return to your import settings.
2. Click Advanced settings.
3. Go through each tab and apply your preferred settings, clicking Save after each change.

4

Review and update import mapping

In the Edit mapping tab, you’ll see several new import fields. These mostly concern localized data (e.g. price_be for prices for Belgium-based customers).

1. Review and compare the Import fields and Project field columns.
2. Ensure all fields are mapped correctly.
3. Check that new market-specific fields (like price_netherlands or title_fr) are mapped to the right field type.
4. Click Save & import to begin importing your data.

5

Check your items

1. Go to Items.
2. Check your items and ensure all prices, translations, location information, etc. look correct.
3. If you find issues, return to the Edit mapping page to adjust your product data.

6

Copy and recreate your import rules (if using)

After running your import, copy and review any import rules that reference localized data (e.g. prices or translated titles) and update them to use the new market-specific fields.

1. Go to Setup > Import rules.
2. Click + Create rule.
3. In the pop up, click Copy rule(s).
4. At the field From project, select the project that contains the import rules you want to copy.
5. Click Copy here.
6. Review each copied rule. Update any references to old fields (like title or price) to the new market-specific fields (e.g. title_fr, price_netherlands).
7. Click Save.
8. Repeat this for each import rule.

7

Recreate your channels

After importing and fixing your import rules, you can start recreating your channels in a new project. You’ll need to update all channel rules and mapping to use the new field structure.

Recreating marketplace (API) channels

Go to Channels.

1. Click + Create channel.
2. Select the channel you need to recreate.
3. Fill in your channel settings to match your old channel.
4. In Categories, go to Manual categorization > Copy categories. A pop up will appear.
5. For From project, select your old project containing your channel. For From channel, select the channel within that project that matches the channel you’re recreating.
6. Click Copy here. This applies your old categorization to your new channel, saving you time.
7. Go to the Rules step and click + Create rule.
8. In the pop up, click Copy rule(s).
9. At the field From project, select the project that contains the rules you want to copy.
10. Click Copy here to copy the rule(s).
11. Check your copied rule. If applicable or relevant, update the project fields used.
12. Click Save.
13. Repeat the rule copying process for each rule.
14. Go to the Build step.
15. Carefully go through and map your Shared and Category attributes.
16. Click Save.
17. Go to the Quality step and review any fields missing data or presenting issues.
18. Return to the Settings step and provide your seller account.
19. Click Activate API.

Repeat these steps for each marketplace channel.

Recreating feed channels

1. Go to Channels.
2. Click + Create channel.
3. Select the feed you need to recreate.
4. Fill in your channel settings to match your old channel.
5. In Categories, go to Manual categorization > Copy categories. A pop up will appear.
6. For From project, select your old project containing your channel. For From channel, select the channel within that project that matches the channel you’re recreating.
7. Click Copy here. This applies your old categorization to your new channel, saving you time.
8. Go to the Rules step and click + Create rule.
9. In the pop up, click Copy rule(s).
10. At the field From project, select the project that contains the rules you want to copy.
11. Click Copy here to copy the rule(s).
12. Check your copied rule. If applicable or relevant, update the project fields used.
13. Click Save.
14. Repeat steps 12-13 for each rule.
15. Go to the Mapping step.
16. Carefully go through and map your fields to the listed attributes.
17. Click Save.
18. Go to the Quality step and review any fields missing data or presenting issues.
19. Go to the Preview & export step.
20. Click Activate feed.

Repeat these steps for each feed you want to recreate.

Recreating dynamic ads

1. Go to Dynamic ads.
2. Click + Create ad channel.
3. Select the tab of the dynamic ad channel you need to recreate.
4. Fill in your channel settings to match your old channel.
5. Go to the Rules step and click + Create rule.
6. In the pop up, click Copy rule(s).
7. At the field From project, select the project that contains the rules you want to copy.
8. Click Copy here to copy the rule(s).
9. Check your copied rule. If applicable or relevant, update the project fields used.
10. Click Save.
11. Repeat steps 12-13 for each rule.
12. Go to the Campaigns step and re-do your old dynamic ads channel settings.
13. In Ad groups, copy/recreate any rules previously used.
14. Click Save.
15. In Build, -do your old dynamic ads settings, updating or mapping any relevant fields.
16. Go to the Preview step and resolve any open issues.
17. Return to the Settings step.
18. Click Activate.

Repeat these steps for each dynamic ad channel you want to recreate.

8

Deactivate your old channels

Once your new channels ready, deactivate the old ones in your old project to prevent duplicate listings.

Tip: Deactivating also allows you to reference them in case you need to check or adjust your new settings to match your old channels.

Modern version

1. Return to All projects and select your old project.

Legacy version

1. Return to Projects and select your old project.

1. Go to Channels / Dynamic ads.
2. Go through your channels and deactivate (not delete) each one.

   1. Marketplaces (APIs): Settings > Deactivate API
   2. Feeds: Settings > Deactivate
   3. Ads: Preview & export > Deactivate feed

9

Run your new channels

Modern version

1. Click All projects and select your new project.

Legacy version

1. Click Projects and select your new project.

1. Go to Channels.
2. Click Run now for each channel.

10

Troubleshooting

Since multiple channels may be running simultaneously, wait 24 hours before reviewing each channel for errors or issues.

Change summary

• Sections updated: Create a new project, Deactivate your old channels, and Run your new channels.
• Legacy version / Modern version tabs added: 3.
• Terminology updated: Projects / Create Project and All projects / Add project.
• Items flagged for review: None.