---
title: InventorySetQuantitiesPayload - GraphQL Admin
description: Return type for `inventorySetQuantities` mutation.
api_version: unstable
api_name: admin
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/unstable/payloads/InventorySetQuantitiesPayload
  md: https://shopify.dev/docs/api/admin-graphql/unstable/payloads/InventorySetQuantitiesPayload.md
---

# Inventory​Set​Quantities​Payload

payload

Return type for `inventorySetQuantities` mutation.

## Fields

* inventory​Adjustment​Group

  [Inventory​Adjustment​Group](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryAdjustmentGroup)

  The group of changes made by the operation.

* user​Errors

  [\[Inventory​Set​Quantities​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventorySetQuantitiesUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [inventory​Set​Quantities](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventorySetQuantities)

  mutation

  Set quantities of specified name using absolute values. This mutation supports compare-and-set functionality to handle concurrent requests properly. If `ignoreCompareQuantity` is not set to true, the mutation will only update the quantity if the persisted quantity matches the `compareQuantity` value. If the `compareQuantity` value does not match the persisted value, the mutation will return an error. In order to opt out of the `compareQuantity` check, the `ignoreCompareQuantity` argument can be set to true.

  ***

  **Note:** Only use this mutation if calling on behalf of a system that acts as the source of truth for inventory quantities, otherwise please consider using the \<a href="https://shopify.dev/api/admin-graphql/latest/mutations/inventoryAdjustQuantities">inventoryAdjustQuantities\</a> mutation.\</p> \<p>Opting out of the \<code>\<span class="PreventFireFoxApplyingGapToWBR">compare\<wbr/>Quantity\</span>\</code> check can lead to inaccurate inventory quantities if multiple requests are made concurrently. It is recommended to always include the \<code>\<span class="PreventFireFoxApplyingGapToWBR">compare\<wbr/>Quantity\</span>\</code> value to ensure the accuracy of the inventory quantities and to opt out of the check using \<code>\<span class="PreventFireFoxApplyingGapToWBR">ignore\<wbr/>Compare\<wbr/>Quantity\</span>\</code> only when necessary.

  ***

  ***

  **Caution:** As of 2026-01, this mutation supports an optional idempotency key using the \<code>@idempotent\</code> directive. As of 2026-04, the idempotency key is required and must be provided using the \<code>@idempotent\</code> directive. For more information, see the \<a href="https://shopify.dev/docs/api/usage/idempotent-requests">idempotency documentation\</a>.

  ***

  * input

    [Inventory​Set​Quantities​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/InventorySetQuantitiesInput)

    required

    ### Arguments

    The information required to set inventory quantities.

  ***

***

## Map

### Mutations with this payload

* [inventory​Set​Quantities](https://shopify.dev/docs/api/admin-graphql/unstable/types/inventorySetQuantities)