---
title: >-
  Optional groupObjects argument in bulk operations mutations that offers faster
  and more reliable job execution - 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/optional-groupobjects-argument-in-bulk-operations-mutations-that-offers-faster-and-more-reliable-job-execution
  md: >-
    https://shopify.dev/changelog/posts/optional-groupobjects-argument-in-bulk-operations-mutations-that-offers-faster-and-more-reliable-job-execution.md
metadata:
  effectiveApiVersion: 2025-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-03-27T12:55:24-04:00'
  postedAt: '2025-06-27T12:00:00-04:00'
  updatedAt: '2025-04-02T12:49:43-04:00'
  effectiveAt: '2025-06-27T12:00:00-04:00'
---

June 27, 2025

# Optional `groupObjects` argument in bulk operations mutations that offers faster and more reliable job execution

DateJune 27, 2025

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

FlagsUpdate

SurfacesAPI

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

We've introduced a new `groupObjects` argument to `bulkOperationRunQuery` and `bulkOperationRunMutation` mutations in the GraphQL Admin API that allow clients optionally to disable grouping and benefit from faster and more reliable bulk operation job runs.

The JSONL output file that GraphQL Admin API bulk operations jobs generate by default places child objects directly below their corresponding parent objects. Ensuring such grouping is costly and results in slower job run and increases chances of job timeout.

If you do not need grouping in the JSONL output, set `groupObjects` to `false` to benfit from faster and more reliable bulk operation jobs.
