# Bulk operation docs inconsistency

**URL:** <https://community.shopify.dev/t/bulk-operation-docs-inconsistency/28477>\
**Category:** GraphQL Admin API Troubleshooting\
**Tags:** general-gql-troubles\
**Created:** [January 19, 2026, 12:30pm UTC](https://community.shopify.dev/t/bulk-operation-docs-inconsistency/28477 "2026-01-19T12:30:01Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![sinuhe](https://sea1.discourse-cdn.com/shopifycommunity/user_avatar/community.shopify.dev/sinuhe/32/3759_2.png) [@sinuhe](https://community.shopify.dev/u/sinuhe)\
**Post date:** [January 19, 2026, 12:30pm UTC](https://community.shopify.dev/t/bulk-operation-docs-inconsistency/28477/1 "2026-01-19T12:30:01Z")

</div>

Hi there,

at [bulkOperationRunQuery - GraphQL Admin](https://shopify.dev/docs/api/admin-graphql/latest/mutations/bulkoperationrunquery#arguments), we can see how the ‘groupObjects’ argument is required and has default value at the same time.

Please could you take a look?

 ![image](https://global.discourse-cdn.com/shopifycommunity/original/2X/0/045cfc724c5e32756f26920f79d09d0d53297d47.png)

---

<div class="post-metadata">

**Author:** ![Donal-Shopify](https://sea1.discourse-cdn.com/shopifycommunity/user_avatar/community.shopify.dev/donal-shopify/32/10850_2.png) [@Donal-Shopify](https://community.shopify.dev/u/Donal-Shopify)\
**Post date:** [January 19, 2026, 1:19pm UTC](https://community.shopify.dev/t/bulk-operation-docs-inconsistency/28477/2 "2026-01-19T13:19:03Z")

</div>

Hi @sinuhe Good catch - the docs are showing `groupObjects` as both “required” and having a default value, which doesn’t make sense.

Having intorspected the schema, `groupObjects` is optional. It defaults to `false`, so if you omit it entirely your bulk operation returns flat JSONL (no grouping).

I’m raising this with the docs team to get the “required” badge removed. I’ll update this thread once I hear back from them. Thanks for flagging!

---

<div class="post-metadata">

**Author:** ![Donal-Shopify](https://sea1.discourse-cdn.com/shopifycommunity/user_avatar/community.shopify.dev/donal-shopify/32/10850_2.png) [@Donal-Shopify](https://community.shopify.dev/u/Donal-Shopify)\
**Post date:** [January 27, 2026, 8:58am UTC](https://community.shopify.dev/t/bulk-operation-docs-inconsistency/28477/3 "2026-01-27T08:58:29Z")

</div>

Quick update on this one @sinuhe: In GraphQL, `Boolean!` means the type is non-null (you can’t pass `null` as a value), which is what triggers the “required” badge in our docs. But the argument also has a default value of `false`, so if you omit it entirely the server uses that default.

So technically it’s “required” from the schema’s perspective (must be a non-null Boolean when provided), but optional from your perspective as a developer (you can skip it and get the default).

You’re right that showing both badges together is confusing though. I’ve raised this with the docs team and there’s an active discussion about whether to hide the “required” badge when a default value exists, since from a practical standpoint an argument with a default isn’t something you need to worry about providing. I’ll update this thread if anything changes!
