---
title: store execute
description: >-
  Executes an Admin API GraphQL query or mutation on the specified store using
  previously stored app authentication.
api_name: shopify-cli
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/store/store-execute'
  md: 'https://shopify.dev/docs/api/shopify-cli/store/store-execute.md'
---

# store execute

Executes an Admin API GraphQL query or mutation on the specified store using previously stored app authentication.

Run `shopify store auth` first to create stored auth for the store.

Mutations are disabled by default. Re-run with `--allow-mutations` if you intend to modify store data.

#### Flags

The following flags are available for the `store execute` command:

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

  **string**

  **required**

  **env: SHOPIFY\_FLAG\_STORE**

  The myshopify.com domain of the store to execute against.

* **--allow-mutations**

  **env: SHOPIFY\_FLAG\_ALLOW\_MUTATIONS**

  Allow GraphQL mutations to run against the target store.

* **--no-color**

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

  Disable color output.

* **--output-file \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_OUTPUT\_FILE**

  The file name where results should be written, instead of STDOUT.

* **--query-file \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_QUERY\_FILE**

  Path to a file containing the GraphQL query or mutation. Can't be used with --query.

* **--variable-file \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_VARIABLE\_FILE**

  Path to a file containing GraphQL variables in JSON format. Can't be used with --variables.

* **--verbose**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output.

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

  **string**

  **env: SHOPIFY\_FLAG\_VERSION**

  The API version to use for the query or mutation. Defaults to the latest stable version.

* **-j, --json**

  **env: SHOPIFY\_FLAG\_JSON**

  Output the result as JSON. Automatically disables color output.

* **-q, --query \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_QUERY**

  The GraphQL query or mutation, as a string.

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

  **string**

  **env: SHOPIFY\_FLAG\_VARIABLES**

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

Examples

### Examples

* ####

  ##### store execute

  ```sh
  shopify store execute [flags]
  ```

***