---
title: app graphiql
description: >-
  Opens a local GraphiQL interface for the GraphQL Admin API using your app's
  authentication.
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-graphiql'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-graphiql.md'
api_name: shopify-cli
---

# app graphiql

Opens a local GraphiQL interface for the GraphQL Admin API using your app's authentication.

The app must be installed on the store. If you don't specify a store, then Shopify CLI prompts you to select one.

Use the `--port` flag to run GraphiQL on a specific local port.

#### Flags

The following flags are available for the `app graphiql` command:

* **--client-id \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_CLIENT\_ID**

  The Client ID of your app.

* **--no-color**

  **env: SHOPIFY\_FLAG\_NO\_COLOR**

  Disable color output.

* **--path \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_PATH**

  The path to your app directory.

* **--port \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_PORT**

  Local port for the GraphiQL server. Must be between 1 and 65535.

* **--reset**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--verbose**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output.

* **--version \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_VERSION**

  The API version to use in GraphiQL. Defaults to the latest stable version.

* **-c, --config \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_APP\_CONFIG**

  The name of the app configuration.

* **-s, --store \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_STORE**

  The myshopify.com domain of the store to open GraphiQL against. The app must be installed on the store. If not specified, you will be prompted to select a store.

* **-v, --variables \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_VARIABLES**

  The values for any GraphQL variables in your query or mutation, in JSON format.

Examples

### Examples

* ####

  ##### app graphiql

  ```sh
  shopify app graphiql [flags]
  ```

***