Combined Listings via the Storefront API

Technical Q&A
,

Topic summary

Core Issue:
Developers are seeking clarification on retrieving Combined Listings data through Shopify’s Storefront API for mobile apps, as official documentation is vague despite an October 2024 announcement claiming support.

Key Findings:

  • Combined Listings appear as standard products in the Storefront API
  • Access requires explicitly activating the combined listing product in the headless sales channel
  • Standard product queries (fetching by handle, retrieving variants) work once properly configured

Technical Solution:
Query combined listings like regular products using GraphQL, accessing combined products through the variants field with properties like availableForSale and sku.

Unexpected Behavior:
One developer reported that disabling “Storefront API access request” in the Partners dashboard paradoxically granted access to combined listing products, though this caused the sales channel to disappear from the products’ publishable menu—suggesting potential configuration conflicts or undocumented requirements.

Status: Partially resolved with workarounds identified, but official documentation gaps remain.

Summarized with AI on October 28. AI used: claude-sonnet-4-5-20250929.
1

We have multiple merchants with mobile apps who use the Combined Listings app. All of the product/collection data in our apps comes from the Storefront API. Therefore, we’re currently looking into whether or not it’s possible to retrieve Combined Listing data using the Storefront API.

I see this developer blog post from October 1, 2024 saying that Combined Listings is supported with the Storefront API, but it’s quite vague:
https://shopify.dev/changelog/storefront-api-support-for-combined-listings

There seems to be a CombinedListing object exposed by the Admin GraphQL API:
https://shopify.dev/docs/api/admin-graphql/latest/objects/CombinedListing

However I’m not finding anything of the sort in the Storefront API documentation:
https://shopify.dev/docs/api/storefront/latest/objects/Product

I’m also not seeing any mention of Combined Listings in the Storefronts documentation:
https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections

Please advise us:

  1. Whether or not it’s possible to retrieve Combined Listings information from the Storefront API.
  2. If #1 is true, how to retrieve Combined Listings information from the Storefront API.

Thank you in advance!

  • Matt
1 Like
2

Hi @matt-at-tapcart ,

Did you get the answer to your questions?

Thanks

3

Hey @matt-at-tapcart , @Fabien_Sebban

I’ve got that to work lately.

It works like a standard product and you can fetch the combined products via variants. The reason I couldn’t get it to work in first place, I had to explicitly activate the combined listing product in the headless sales channel.

See below the query that worked for me to fetch the combined listing as soon as it was activated.

query getProduct {
  product(handle: "xyz") {
    handle
    variants(first: 30) {
      nodes {
        availableForSale
        sku
      }
    }
  }
}
4

Thanks @srccb for your reply.

I had a weird problem with my app. When the Storefront API access request was enabled on the Partners dashboard, I had no access to combined listing products:

Capture d’écran 2025-05-23 à 18.05.58.png
Capture d’écran 2025-05-23 à 18.05.58.png1485×242 30.2 KB

Once I disabled it, I could access every product from the store, including the combined listing one, and the sales channel disappeared from the products’ publishable sales channel menu.