shopifyqlQuery returns error (Query root not found)

Retired Boards Appdev Graphql Basics And Troubleshooting

Topic summary

  • ShopifyQL example calls return a GraphQL error: “Field ‘shopifyqlQuery’ doesn’t exist on type ‘QueryRoot’.”

  • Issue reproduced across multiple Plus shops and API versions; the field isn’t visible in GraphQL Playground, implying it’s not exposed in stable schemas.

  • Another developer confirmed the same error and asked for guidance or a release timeframe.

  • Update: Shopify support stated the feature is only available on the “unstable” API version (pre-release schema). Running the query against the unstable endpoint succeeds.

  • Current status: Workaround is to target the unstable API; no announced timeline for availability in a stable API version. Open question remains when shopifyqlQuery will be released to stable.

Summarized with AI on February 1. AI used: gpt-5.
1

Hi,

Trying new feature here: https://shopify.dev/api/shopifyql/example

However, I keep getting the following error with the example call:

{‘errors’: [{‘message’: “Field ‘shopifyqlQuery’ doesn’t exist on type ‘QueryRoot’”, ‘locations’: [{‘line’: 3, ‘column’: 3}], ‘path’: [‘query’, ‘shopifyqlQuery’], ‘extensions’: {‘code’: ‘undefinedField’, ‘typeName’: ‘QueryRoot’, ‘fieldName’: ‘shopifyqlQuery’}}]}

I have tried later API versions as well, on multiple plus account shops, same error.

Further, I cannot locate the query root in GraphQLPlayground, making me think it hasn’t been exposed despite documentation to the contrary.

Anyone else running into this?

2

I’m getting the same error, any info from the Shopify team on how to run this query or when it will be released?

3

The Shopify team did get back to me, and this is only available in the unstable version of the API. A call with that was successful on my end.

2 Likes
4

Hey! I’d be really interested in chatting with you as I am currently struggling with Shopifyqlquery - can you WhatsApp me? I’m on +44 7496898 721. Happy to pay for any time.