Skip to main content

store bulk execute

Execute bulk operations on a store.

Executes an Admin API GraphQL query or mutation on the specified store as a bulk operation, using previously stored app authentication.

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

Bulk operations let you process large amounts of data asynchronously. Learn more about bulk query operations and bulk mutation operations.

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

Use shopify store bulk status to check the status of your bulk operations.

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

Anchor to -s, --store <value>
-s, --store <value>
string
required
env: SHOPIFY_FLAG_STORE

The myshopify.com domain of the store.

Anchor to --allow-mutations
--allow-mutations
env: SHOPIFY_FLAG_ALLOW_MUTATIONS

Allow GraphQL mutations to run against the target store.

Anchor to --no-color
--no-color
env: SHOPIFY_FLAG_NO_COLOR

Disable color output.

Anchor to --output-file <value>
--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.

Anchor to --query-file <value>
--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.

Anchor to --variable-file <value>
--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.

Anchor to --verbose
--verbose
env: SHOPIFY_FLAG_VERBOSE

Increase the verbosity of the output.

Anchor to --version <value>
--version <value>
string
env: SHOPIFY_FLAG_VERSION

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

Anchor to --watch
--watch
env: SHOPIFY_FLAG_WATCH

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

Anchor to -q, --query <value>
-q, --query <value>
string
env: SHOPIFY_FLAG_QUERY

The GraphQL query or mutation to run as a bulk operation.

Anchor to -v, --variables <value>
-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.


Was this page helpful?