---
title: app bulk execute
description: >-
  Executes an Admin API GraphQL query or mutation on the specified store, as a
  bulk operation.
source_url:
  html: 'https://shopify.dev/docs/api/shopify-cli/app/app-bulk-execute'
  md: 'https://shopify.dev/docs/api/shopify-cli/app/app-bulk-execute.md'
api_name: shopify-cli
---

# app bulk execute

Executes an Admin API GraphQL query or mutation on the specified store, as a bulk operation. Mutations are only allowed on dev stores.

Bulk operations allow you to process large amounts of data asynchronously. Learn more about [bulk query operations](https://shopify.dev/docs/apps/build/apis/graphql-admin/bulk-operations/queries) and [bulk mutation operations](https://shopify.dev/docs/apps/build/apis/graphql-admin/bulk-operations/imports).

Use [`bulk status`](https://shopify.dev/docs/api/shopify-cli/app/app-bulk-status) to check the status of your bulk operations.

#### Flags

The following flags are available for the `app bulk execute` command:

* **--auth-alias \<value>**

  **string**

  **env: SHOPIFY\_FLAG\_AUTH\_ALIAS**

  Alias of the Shopify account to use for authentication.

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

  **string**

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

  The Client ID of your app.

* **--json-schema**

  **env: SHOPIFY\_FLAG\_JSON\_SCHEMA**

  Print the command's JSON schemas.

* **--no-color**

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

  Disable color output.

* **--no-input**

  **env: SHOPIFY\_FLAG\_NO\_INPUT**

  Disable interactive prompts and browser authentication.

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

  **string**

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

  The file path where results should be written if --watch is specified. If not specified, results will be written to 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 JSONL format (one JSON object per line). Can't be used with --variables.

* **--verbose**

  **env: SHOPIFY\_FLAG\_VERBOSE**

  Increase the verbosity of the output. May include sensitive data.

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

  **string**

  **env: SHOPIFY\_FLAG\_VERSION**

  The API version to use for the bulk operation. If not specified, uses the latest stable version.

* **--watch**

  **env: SHOPIFY\_FLAG\_WATCH**

  Wait for bulk operation results before exiting. Defaults to false.

* **-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 to run as a bulk operation.

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

  **string**

  **env: SHOPIFY\_FLAG\_STORE**

  The store domain. Must be an existing dev store.

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

  **string**

  **env: SHOPIFY\_FLAG\_VARIABLES**

  The values for any GraphQL variables in your mutation, in JSON format. Can be specified multiple times.

### Examples

* #### App bulk execute

  ##### app bulk execute

  ```sh
  shopify app bulk execute [flags]
  ```

***