---
title: New Queries for Bulk Operations - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/posts/new-queries-for-bulk-operations'
  md: 'https://shopify.dev/changelog/posts/new-queries-for-bulk-operations.md'
metadata:
  effectiveApiVersion: 2026-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-10-22T09:23:21-04:00'
  postedAt: '2025-10-31T12:00:00-04:00'
  updatedAt: '2025-10-22T21:35:44-04:00'
  effectiveAt: '2025-10-30T12:00:00-04:00'
---

October 31, 2025

# New Queries for Bulk Operations

DateOctober 31, 2025

Version[2026-01](https://shopify.dev/changelog?api_version=2026-01)

FlagsNew

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

We've introduced new GraphQL queries to help you retrieve and manage bulk operations in the Admin API.

## What's Changed

Here's an overview of the updates:

### New Bulk Operations Retrieval Queries

We have added two new queries for accessing your bulk operations:

* `bulkOperations`: A connection-based query that returns a paginated list of all your bulk operations, complete with filtering and sorting options.
* `bulkOperation`: A single-object query that retrieves a specific bulk operation by its ID.

### Enhanced Filtering and Search Capabilities

The `bulkOperations` connection now supports flexible querying with the following features:

* **Status Filtering:** Locate operations by status (e.g., canceled, completed, running).
* **Type Filtering:** Filter operations by type (query or mutation).
* **Date Filtering:** Search for operations created before or after a specific date.
* **Sorting Options:** Sort operations by `created_at`, `completed_at`, or `status` in ascending or descending order.
* **Search Syntax:** Use `field:value` patterns for precise filtering.

## What You Need to Do

Depending on your requirements, follow these steps:

### To List and Filter Bulk Operations

Utilize the `bulkOperations` connection query with search syntax:

```graphql
query {
  bulkOperations(
    first: 10
    query: "status:completed operation_type:query created_at:>2025-10-10"
    sortKey: CREATED_AT
    reverse: true
  ) {
    edges {
      node {
        id
        status
        query
        createdAt
        completedAt
        url
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
    }
  }
}
```

### To Retrieve a Specific Bulk Operation

Use the `bulkOperation` query:

```graphql
query {
  bulkOperation(id: "gid://shopify/BulkOperation/123456789") {
    id
    status
    query
    createdAt
    completedAt
    url
    errorCode
  }
}
```

### If You're Using Existing Bulk Operation Workflows

No changes are necessary. The `currentBulkOperation` can still be used but is being deprecated.

## Why We Made This Change

Previously, you could only access the most recent bulk operation through `currentBulkOperation`. These new queries offer:

* Complete visibility into all your bulk operations, not just the current one.
* Enhanced debugging capabilities by filtering operations by status or date.
* Efficient pagination for managing large numbers of operations.
* Simplified monitoring, debugging, and management of bulk operations at scale.

## Learn More

* [Bulk Operations Queries Guide](https://shopify.dev/api/usage/bulk-operations/queries)