shopify app and store graphiql commands open authenticated local sessions

Introduced 2026-07-06 · score 0.98

HOW TO USE IT

When inspecting Admin API queries for an app, run `shopify app graphiql` with the selected store; the app must be installed there. For store authentication, first run `shopify store auth`, then run `shopify store graphiql`; pass `--allow-mutations` if mutations should be allowed.

WHY THIS HELPS

Inspect or test Admin API queries for an app or store from a local GraphiQL session.

REQUIREMENTS AND LIMITATIONS

• Version: 4.4.0
• app graphiql --store <value>: The myshopify.com domain; if omitted, CLI prompts for a store. The app must be installed on it.
• app graphiql --port <value>: Local GraphiQL server port; must be between 1 and 65535.
• app graphiql --path <value>: Path to the app directory.
• app graphiql --version <value>: GraphiQL API version; defaults to latest stable.
• app graphiql --variables <value>: GraphQL variable values in JSON format.
• store graphiql --store <value> (required): The myshopify.com domain of the store.
• store graphiql --allow-mutations: Allow GraphQL mutations against the target store; mutations are blocked by default.
• store graphiql --port <value>: Local GraphiQL server port; must be between 1 and 65535.
• store graphiql --version <value>: GraphiQL API version; defaults to latest stable.
• store graphiql --variables <value>: GraphQL variable values in JSON format.
• store auth --store <value> (required): The myshopify.com domain of the store.
• store auth --scopes <value> (required): Comma-separated Admin API scopes to request for the app.
• Prerequisite: For app GraphiQL, the app must be installed on the selected store.
• Prerequisite: For store GraphiQL, run `shopify store auth` first to create stored authentication.
• The app must be installed on the store for app-backed GraphiQL.
• Store GraphiQL uses authentication created by `shopify store auth`; mutations are blocked unless `--allow-mutations` is passed.
• The local port must be between 1 and 65535.

FIRST-PARTY EVIDENCE

• https://github.com/Shopify/cli/releases/tag/4.4.0
• https://github.com/Shopify/cli/pull/7382
• https://shopify.dev/docs/api/shopify-cli/app/app-graphiql
• https://shopify.dev/docs/api/shopify-cli/store/store-auth
• https://shopify.dev/docs/api/shopify-cli/store/store-graphiql

Check the installed version and the source before using it. Entry JSON

Report a problem with this card