Syntax for "query" argument in GraphQL (Storefront API)

[Zolbayar]

@Johan_Land

So, this is a bit of a mess. And believe it or not, this thread is currently the best documentation on how to use the query field.

@Shopify, please help us out here as we’re currently doing guesswork.

Here’s what I know so far:

While you can see what query fields are claimed to be supported here (https://help.shopify.com/en/api/graphql-admin-api/reference/queryroot) it is actually not accurate. Only some of those fields are in practice supported. But, some actually do work.

I’m currently working on orders() and for this it seems that the status of the working/non-working query fields are:

• email: not working

• status: not working?

• fulfillment_status: IS WORKING

• customer_id: IS WORKING

When running queries, the correct format is this:

orders(first:3, query:“customer_id:871660388411”)

The incorrect format is this (incorrectly claimed to be correct in a previous post):

orders(first:3, query:“customer_id=871660388411”)

(e.g. do not use ‘=’ but instead ‘:’

It seems that the query field is insensitive to extra quotations for at least numbers. The following does work:

orders(first:3, query:“customer_id:‘871660388411’”)

It is also insensitive to left out quotations for strings.

I hope this helps someone out there trying to get this working despite of Shopify’s complete lack of documentation and support for the community.

Indeed, it’s still the best documentation on how to use the query field/