---
title: BulkOperation - GraphQL Admin
description: >-
  An asynchronous operation that exports large datasets or imports data in bulk.
  Create bulk operations using
  [bulkOperationRunQuery](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunQuery)
  to export data or
  [bulkOperationRunMutation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunMutation)
  to import data.


  After creation, check the
  [`status`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.status)
  field to track progress. When completed, the
  [`url`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.url)
  field contains a link to download results in [JSONL](http://jsonlines.org/)
  format. The
  [`objectCount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.objectCount)
  field shows the running total of processed objects, while
  [`rootObjectCount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.rootObjectCount)
  tracks only root-level objects in nested queries.


  If an operation fails but retrieves partial data, then the
  [`partialDataUrl`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.partialDataUrl)
  field provides access to incomplete results.


  > Note: `url` and `partialDataUrl` values expire after seven days.


  Learn more about
  [exporting](https://shopify.dev/docs/api/usage/bulk-operations/queries) and
  [importing](https://shopify.dev/docs/api/usage/bulk-operations/imports) data
  in bulk.
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation.md'
---

# Bulk​Operation

object

Requires Only accessible by supported access tokens: <https://shopify.dev/docs/api/usage/bulk-operations/queries#access-token-considerations>.

An asynchronous operation that exports large datasets or imports data in bulk. Create bulk operations using [bulkOperationRunQuery](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunQuery) to export data or [bulkOperationRunMutation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunMutation) to import data.

After creation, check the [`status`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.status) field to track progress. When completed, the [`url`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.url) field contains a link to download results in [JSONL](http://jsonlines.org/) format. The [`objectCount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.objectCount) field shows the running total of processed objects, while [`rootObjectCount`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.rootObjectCount) tracks only root-level objects in nested queries.

If an operation fails but retrieves partial data, then the [`partialDataUrl`](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperation#field-BulkOperation.fields.partialDataUrl) field provides access to incomplete results.

***

Note

`url` and `partialDataUrl` values expire after seven days.

***

Learn more about [exporting](https://shopify.dev/docs/api/usage/bulk-operations/queries) and [importing](https://shopify.dev/docs/api/usage/bulk-operations/imports) data in bulk.

## Fields

* completedAt
* createdAt
* errorCode
* fileSize
* id
* objectCount
* partialDataUrl
* query
* rootObjectCount
* status
* type
* url

***

## Map

### Fields and connections with this object

* [BulkOperationConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/BulkOperationConnection#returns-nodes)
* [BulkOperationEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/BulkOperationEdge#field-BulkOperationEdge.fields.node)

***

## Queries

* bulkOperation
* bulkOperations
* currentBulkOperation: deprecated

***

## BulkOperation Queries

### Queried by

* [bulk​Operation](https://shopify.dev/docs/api/admin-graphql/latest/queries/bulkOperation)
* [bulk​Operations](https://shopify.dev/docs/api/admin-graphql/latest/queries/bulkOperations)

***

## Mutations

* bulkOperationCancel
* bulkOperationRunMutation
* bulkOperationRunQuery

***

## BulkOperation Mutations

### Mutated by

* [bulk​Operation​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationCancel)
* [bulk​Operation​Run​Mutation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunMutation)
* [bulk​Operation​Run​Query](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkOperationRunQuery)

***

## Interfaces

* Node

***

## BulkOperation Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)