New markets query "type" argument not working as expected

In my partner Deprecated API calls section I am getting this message:

“As of GraphQL Admin API version 2025-04, the Catalog APIs now support multiple markets per catalog. Use type: REGION to maintain single market behavior.”

But testing the 2025-04 API version using the new “type” argument has unexpected results

I’m running this query:

    {
        markets (first: 100, type: LOCATION) {
            pageInfo {
                hasNextPage
            }
            edges {
                cursor
                node {
                    type
                    currencySettings {
                        baseCurrency {
                            currencyCode
                        }
                    }
                    id
                    name
                    primary
                    priceList {
                        id
                    }
                }
            }
        }
    }

But the results I get back contain markets that have a type as REGION.

I’m expecting to only get back markets that have a type as LOCATION.

Is this a bug?

1 Like

Hey @Chris_Geelhoed :waving_hand: - are you seeing location-type markets as well as region-type markets pop up in the response together?

I think I have a hunch in terms of what might be happening here, but need to do a bit more digging. If you’re able to share a shop ID here in the thread, I’m happy to troubleshoot further - hope to hear from you soon!

Hi Alan, thank you for looking into this for me.

I’m asking for LOCATION type markets, but I’m only getting back REGION markets.

The shop ID is gid://shopify/Shop/45745242270

No worries - thanks for sharing the shop info there @Chris_Geelhoed - I think I’ve been able to replicate this internally on my end, I’m going to do some more digging and touch base with the team. I’ll loop back with you here when I have more info/next steps to share - this is definitely a bit odd.

Thanks a lot Alan, appreciate it :folded_hands:

Hey @Chris_Geelhoed :waving_hand: - just following up here. I was able to confirm that the “type” field/filter is actually related to the “new” Markets functionality that is in the process of being rolled out (which I think you may have mentioned in your initial post): Introducing Markets: A Unified Home for Business Expansion (2024) - Shopify Canada

This was announced in 2024, but the wide rollout for the new functionality is still ongoing at the moment. It looks like your test shop is currently set up to use the “legacy Markets” set up, but my understanding is that we are looking at rolling out the “new” Markets functionality out to everyone in the near-term.

I can’t guarantee an exact turnaround time on that, but it should happen within the next couple of months at most.

Once you’re migrated over, the query should work though - I can’t say when this will happen for your shop specifically, but the UI should update when you are migrated and you’ll see the changes.

Thanks @Alan_G

I have received this message from Shopify:

We recommend ensuring your app is compatible with the new Markets as soon as possible. A few things to note:

  • The new Markets will begin rolling out to stores in April, only to merchants using compatible apps. Stores using your app(s) will be eligible to use the new Markets once your app(s) have been updated to API version 2025.04 or later.
  • Merchants using the new version of Markets will receive a warning that the app is not compatible at the time of install.
  • On July 1, 2025, all merchants will receive access to the new Markets. At this time, merchants using apps that have not been updated to the 2025-04 version may have a broken experience when interacting with the new version of Markets. Please also note that Plus merchants will have the option to choose their opt-in date, regardless of whether their apps have been updated.

Please let me know if you have any questions and thanks for your partnership in ensuring your app will be compatible with the new Markets.

We need to upgrade to the 2025-04 API version, or Shopify will show a warning message when our app is installed.

So what is the recommended action?

Hi @Alan_G following up on the recommended action here. We want to prepare our app for the new Shopify markets API but it is not clear what needs to be done on our end

Hey @Chris_Geelhoed - thanks for waiting on this. Just wanted to loop back with you here - I’m still digging into this on my end just to ensure we share the right recommendations, but I did want to touch base with you to let you know we’re still looking into this for you.

Speak with you as soon as I have more info on my end!

Thank you for looking into this Alan

No worries Chris, just getting back in touch on this. I was able to confirm that we will notify merchants if there are apps who haven’t migrated to the new Markets set-up (this will surface in multiple spots and eventually in the admin’s landing page, as usually happens), but in terms of what’s needed to be done to migrate over successfully, there is a bit more info in this thread if you haven’t checked it out yet. My understanding is that you’d just need to follow these three steps though:

  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.

Setting up a new developer shop with the New Markets preview is one requirement - so I wanted to mention that as well. One thing that’s not mentioned in the thread there though is using unifiedMarkets to determine if a merchant is using “Legacy” or "New Markets - just wanted to include that since it might be helpful too.

Hope this helps - helt me know if I can clarify anything as always.

@Alan_G the thing that I don’t really understand is that we need to upgrade to 2025-04 to not be flagged as an out of date app, but at the same time the 2025-04 API version will not work correctly if the merchant is using the old markets.

So is the recommendation just to upgrade to the new API version even though it won’t work as expected?