---
title: app execute
description: >-
  Executes an Admin API GraphQL query or mutation on the specified store.
  Mutations are only allowed on dev stores.

    For operations that process large amounts of data, use [`bulk execute`](/docs/api/shopify-cli/app/app-bulk-execute) instead.
api_name: shopify-cli
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-execute'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-execute.md'
---

# app execute

Executes an Admin API GraphQL query or mutation on the specified store. Mutations are only allowed on dev stores.

For operations that process large amounts of data, use [`bulk execute`](https://shopify.dev/docs/api/shopify-cli/app/app-bulk-execute) instead.

## Flags

The following flags are available for the `app execute` 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.

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

  **string**

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

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

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

  **string**

  **env: SHOPIFY\_FLAG\_PATH**

  The path to your app directory.

* **--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.

* **--reset**

  **env: SHOPIFY\_FLAG\_RESET**

  Reset all your settings.

* **--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.

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

  **string**

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

  The name of the app configuration.

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

  **string**

  **env: SHOPIFY\_FLAG\_QUERY**

  The GraphQL query or mutation, as a string.

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

  **string**

  **env: SHOPIFY\_FLAG\_STORE**

  The myshopify.com domain of the store to execute 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 execute

  ##### app execute

  ```bash
  shopify app execute [flags]
  ```