---
title: bulkOperationRunQuery - GraphQL Admin
description: |-
  Creates and runs a bulk operation query.

  See the [bulk operations guide](https://shopify.dev/api/usage/bulk-operations/queries) for more details.
api_version: 2026-01
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2026-01/mutations/bulkoperationrunquery
  md: https://shopify.dev/docs/api/admin-graphql/2026-01/mutations/bulkoperationrunquery.md
---

# bulk​Operation​Run​Query

mutation

Creates and runs a bulk operation query.

See the [bulk operations guide](https://shopify.dev/api/usage/bulk-operations/queries) for more details.

## Arguments

* group​Objects

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/2026-01/scalars/Boolean)

  requiredDefault:false

  Enables grouping objects directly under their corresponding parent objects in the JSONL output. Enabling grouping slows down bulk operations and increases the likelihood of timeouts. Only enable grouping if you depend on the grouped format.

* query

  [String!](https://shopify.dev/docs/api/admin-graphql/2026-01/scalars/String)

  required

  The query to be executed in bulk.

***

## Bulk​Operation​Run​Query​Payload returns

* bulk​Operation

  [Bulk​Operation](https://shopify.dev/docs/api/admin-graphql/2026-01/objects/BulkOperation)

  The newly created bulk operation.

* user​Errors

  [\[Bulk​Operation​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2026-01/objects/BulkOperationUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### bulkOperationRunQuery reference

## Mutation Reference

```graphql
mutation bulkOperationRunQuery($query: String!, $groupObjects: Boolean!) {
  bulkOperationRunQuery(query: $query, groupObjects: $groupObjects) {
    bulkOperation {
      # BulkOperation fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "query": "<your-query>",
  "groupObjects": true
}
```

##### Variables

```
{
  "query": "<your-query>",
  "groupObjects": true
}
```