Release of the new Shopify Markets: Changes to the Markets and Catalogs APIs

We are excited to announce the release of the new version of Shopify Markets in developer preview. With this upgrade, merchants will be able to more easily create custom buyer experiences for their retail, B2B, and international customers.

With this update, we are also introducing changes to the Markets and Catalogs APIs. If your app currently interacts with either of these APIs, you will need to update your app to be compatible with the new version of Markets.

Please note that only apps using the Markets and/or Catalogs on API version 2025-04 and later will be compatible with the new version of Markets, which you can access now in developer preview.

Important timeline information:

  • Starting in April, we will be rolling out the new version of Markets only to Shopify merchants who are using compatible apps. In addition, any merchant using the new version of Markets that installs an app using Markets and/or Catalogs and has not yet been updated to the 2025-04 API version will receive a warning that the app is not compatible at the time of install.
  • By July 1, 2025, all merchants will receive access to the new Markets. If your app has not been updated to the 2025-04 API version, merchants using your app may have a broken experience when interacting with the new version of Markets. Please note that Plus merchants, regardless of whether their apps have been migrated, will have the option to choose their opt-in date to the new version of Markets via Test Drive, which may be after July 1, 2025.

Next steps:

  1. Review the developer documentation, API documentation and an overview of notable changes to help inform your testing and update efforts.
  2. Create a new development store and enable the developer preview from your Partner Dashboard to start testing the new Markets functionality.
  3. Update to the 2025-04 API version as soon as possible.

As you begin testing and have questions, please post them here in the “Markets” category on the Shopify developer forum and use the tag newmarkets. We look forward to working with you on this change!

3 Likes

Hey Cole, super cool and thanks for the docs.

Have a question do these new concepts apply to Global-E native integration and apps working with brands on Global-E.

Thank you.

Hey Youness! Yes, that’s correct - this will apply to merchants using Global-e. We are working with the Global-e team on updating their app.

Thanks Cole understood.

So this will solve Web presence limitation with Global-E as well when you have 50+ markets the online store theme context deosn’t work anymore right?

And Global-E will be ready by 1st of July as well?

Also Global-E will be just like any app, it won’t block any Shopify interface evrything will be unified and writable from Shopify?

Last question, currently when i check on Shopify POS, currency still is default store currency, should we expect an update from POS to support this soon?

1 Like

So this will solve Web presence limitation with Global-E as well when you have 50+ markets the online store theme context deosn’t work anymore right?

Correct, there will no longer be a limit of 50 markets.

And Global-E will be ready by 1st of July as well?

Yes, we are working with them on this migration.

Also Global-E will be just like any app, it won’t block any Shopify interface evrything will be unified and writable from Shopify?

Also correct, these merchants will now have access to configure Markets in the admin.

Last question, currently when i check on Shopify POS, currency still is default store currency, should we expect an update from POS to support this soon?

We’re working on this, since we need to add in multi-entity processing to allow for different retail locations to process transactions in different currencies. We’re working on adding this to the dev preview and into the POS app, will let you know when it is added! You should still be able to accurately test different pricing/publishing at different retail locations that use the same currency.

2 Likes

Hey Cole regading Multi entity processing is this scheduled for merchant release in 1st of July as well?

and does multi-entity processing works with other than Shopify Payment especialy Adyen?

Keep me updated when this is added in dev preview. Do we need Shopify payment to start using it for apps for example?

And regarding release? if a merchant creates a new store in April will he have access to these two features?

Thanks

Hey, there!

Thanks for your effort to make Markets an even more powerful tool.

From our experience migrating european Plus-brands to Shopify, there are some markets shortcomings, that time and time again will lead to markets not being a feasible option. This results in a multi-store setup in most cases which, as you can imagine, is sub-optimal.

I really hope with the new markets architecture, there is the necessary groundwork to overcome those issues.

1. market-specific e-mail sender identity for transactional mails
It can be highly confusing for shoppers to get order confirmations and other mails from a e-mail domain that does not match the web presence.
In addition, this has been an issue for enterprise merchants with country-specific support-teams, which want customers to be able to reach the correct support-staff by just responding to their order confirmation.

2. market-specific third party payment gateways
Especially in europe, but I would imagine also elsewhere, there are important payment providers with unique payment options, which are just not offered by Shopify Payments. See TWINT in Switzerland for example. With a market-share of 67% of all payments in Switzerland, they are a must for doing e-commerce in Switzerland.
The problem at hand is: The third party payment solution can only be installed if the shops main location is Switzerland. This means merchants have to bother with a multi-store setup, if they seriously want to enter the swiss market.

There are a few more of these - but basically I’m just interested if this is a case of “look, we’re finished with new markets” or “look, we now have the base to actually enable people to sell everywhere in an unified way, there is more to come”.

Thanks!

2 Likes

Hey Cole regading Multi entity processing is this scheduled for merchant release in 1st of July as well?

Multi entity will be available as part of the new Markets experience for Plus merchants only, behind a feature test drive, planned for May. Plus merchants are then free to opt into the new Markets experience, including multi entity, when it is suitable for them.

and does multi-entity processing works with other than Shopify Payment especialy Adyen?

This is available for Shopify Payments only at present.

Keep me updated when this is added in dev preview. Do we need Shopify payment to start using it for apps for example?

Will do! You will need Shopify Payments to configure multiple entities. Can you elaborate on what you mean to use it for apps?

And regarding release? if a merchant creates a new store in April will he have access to these two features?

The date for new Markets, and multi entity, to be the default experience on new shops is planned for the end of this month, yes. If you create a shop before then and want it to be on the new Markets experience when are ready, feel free to reach out to me directly and we can make it happen.

Hey Kevin, love this feedback, thank you!

With this release, Markets is definitely not done, and there will be much more to come as we continue to work on it and improve its capabilities to make selling to different markets a truly unified, single-store experience. We acknowledge that while this release goes a long way to making that happen, there are still other things we need to work hard on introducing to make that a reality for every merchant.

To answer these two points specifically:

  • market-specific e-mail sender identity for transactional mails is not planned for this release, but again is great feedback.
  • market-specific third party payment gateways is something that is being thought about, but I don’t have a timeline to share on this one right now sorry.
2 Likes

Hi Cole,

I would need a clarification on this aspect of Global-e if you don’t mind
“Also correct, these merchants will now have access to configure Markets in the admin.”

– Does it mean that it will be possible to edit the template by Market through the editor?
– Is this something also for the European customers, right (not limited i.e. to US)?
– when can we expect to see those changes? We are currently working on a customer where the eventual possibility of editing through the editor would be a huge game changer, instead of having to do heavy customizations of the theme manually, so for us it would be really really important to use it as soon as possible (if possible) as it definitely would steer our internal worklogs and workloads to a different direction.

Thanks in advance,
Martina

1 Like

Hi @coleatkinson sorry to bother, do you have by chance any update on the points of my last message?
Thank you so much,
Martina

Hi Martina, we are currently working with Global-e on the specifics of this integration, including the ability to customize themes, but we do not have anything definitive to share right now. We will share more when it is available.