Advanced concepts

Inline fragments enhance query flexibility and reusability by enabling type-specific transformations and conditional inclusion of fields. Inline fragments use the ... on <TYPE> syntax.

For example, you can use the node field on the GraphQL Admin API QueryRoot object to request specific objects by their ID. The object is returned as a generic node object, which doesn't let you request any information other than the ID.

If you use an inline fragment, then you can ask for more specific data to return when the node is of a specific type. This is especially useful on nodes that don't have an easy access point through the QueryRoot object, such as a single LineItem object.

You can specify multiple inline fragments, which enables you to build conditionals in your request that enable you to request different return fields based on the node type. This is useful for selections that can return many different types of fields, such as the nodes connection on the GraphQL Admin API's QueryRoot object, which accepts an array of IDs and can return any number of different node types.

The following example uses all the concepts covered so far to find where a line item is stocked so that it can be fulfilled from that location. The query uses the node field on the QueryRoot object and provides the line item's ID.

You can submit multiple queries or mutations in a single GraphQL request. This enables you to query the same field or run the name mutation multiple times with different arguments.

The syntax for submitting multiple queries has the following key elements:

• At the beginning of the request, declare whether the operations are queries or mutations
• Give each operation a custom alias with <your-custom-name>: <query field or mutation name> (<arguments>)
• The operations don't have to be the same
• Each operation must select the fields that it wants to return

The following example uses multiple customerUpdate mutations to set three different tags on three different customers in a single request:

• Learn more ways to optimize your requests.
• Explore additional guides to learn more about GraphQL at Shopify.