---
title: app bulk execute
description: >-
  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](/docs/api/usage/bulk-operations/queries) and [bulk mutation operations](/docs/api/usage/bulk-operations/imports).

    Use [`bulk status`](/docs/api/shopify-cli/app/app-bulk-status) to check the status of your bulk operations.
api_name: shopify-cli
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'
---

# 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/api/usage/bulk-operations/queries) and [bulk mutation operations](https://shopify.dev/docs/api/usage/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:

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

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

### Examples

* #### app bulk execute

  ##### app bulk execute

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