--- title: InventoryLevel - GraphQL Admin description: |- The quantities of an inventory item at a specific location. Each inventory level connects one [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) to one [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location), tracking multiple quantity states like available, on-hand, incoming, and committed. The [`quantities`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel#field-InventoryLevel.fields.quantities) field provides access to different inventory states. Learn [more about inventory states and relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships). api_version: 2025-07 api_name: admin type: object api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/inventorylevel md: https://shopify.dev/docs/api/admin-graphql/2025-07/objects/inventorylevel.md --- # Inventory​Level object Requires `read_inventory` access scope. The quantities of an inventory item at a specific location. Each inventory level connects one [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) to one [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location), tracking multiple quantity states like available, on-hand, incoming, and committed. The [`quantities`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel#field-InventoryLevel.fields.quantities) field provides access to different inventory states. Learn [more about inventory states and relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships). ## Fields * can​Deactivate [Boolean!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/Boolean) non-null Whether the inventory items associated with the inventory level can be deactivated. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/DateTime) non-null The date and time when the inventory level was created. * deactivation​Alert [String](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/String) Describes either the impact of deactivating the inventory level, or why the inventory level can't be deactivated. * id [ID!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/ID) non-null A globally-unique ID. * item [Inventory​Item!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryItem) non-null Inventory item associated with the inventory level. * location [Location!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location) non-null The location associated with the inventory level. * quantities [\[Inventory​Quantity!\]!](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryQuantity) non-null The quantity of an inventory item at a specific location, for a quantity [name](https://shopify.dev/docs/apps/fulfillment/inventory-management-apps#inventory-states). * scheduled​Changes [Inventory​Scheduled​Change​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryScheduledChangeConnection) non-null Scheduled changes for the requested quantity names. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/2025-07/scalars/DateTime) non-null The date and time when the inventory level was updated. *** ## Map ### Fields and connections with this object * {}[InventoryItem.inventoryLevel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryItem#field-InventoryItem.fields.inventoryLevel) * {}[InventoryItem.inventoryLevels](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryItem#field-InventoryItem.fields.inventoryLevels) * <->[InventoryLevelConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-07/connections/InventoryLevelConnection#returns-nodes) * {}[InventoryLevelEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryLevelEdge#field-InventoryLevelEdge.fields.node) * {}[InventoryScheduledChange.inventoryLevel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/InventoryScheduledChange#field-InventoryScheduledChange.fields.inventoryLevel) * {}[Location.inventoryLevel](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location#field-Location.fields.inventoryLevel) * {}[Location.inventoryLevels](https://shopify.dev/docs/api/admin-graphql/2025-07/objects/Location#field-Location.fields.inventoryLevels) *** ## Queries * [inventory​Level](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryLevel) query Returns an [InventoryLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) object by ID. *** ## \InventoryLevel Queries ### Queried by * \[inventory​Level](https://shopify.dev/docs/api/admin-graphql/2025-07/queries/inventoryLevel) *** ## Mutations * [inventory​Activate](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryActivate) mutation Activates an inventory item at a [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) by creating an [`InventoryLevel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) that tracks stock quantities. This enables you to manage inventory for a [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) at the specified location. When you activate an inventory item, you can set its initial quantities. The [`available`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryActivate#arguments-available) argument sets the quantity that's available for sale. [`onHand`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryActivate#arguments-onHand) argument sets the total physical quantity at the location. If you don't specify quantities, then `available` and `onHand` default to zero. *** Caution As of version `2026-01`, this mutation supports an optional idempotency key using the `@idempotent` directive. As of version `2026-04`, the idempotency key is required and must be provided using the `@idempotent` directive. For more information, see the [idempotency documentation](https://shopify.dev/docs/api/admin/idempotency). *** Learn more about [managing inventory quantities and states](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states). * [inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryBulkToggleActivation) mutation Activates or deactivates an inventory item at multiple locations. When you activate an [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) at a [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location), that location can stock and track quantities for that item. When you deactivate an inventory item at a location, the inventory item is no longer stocked at that location. The mutation accepts an inventory item ID and a list of location-specific activation settings. It returns the updated inventory item and any activated [`InventoryLevel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) objects. Learn more about [managing inventory quantities and states](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships). *** ## <\~> InventoryLevel Mutations ### Mutated by * <\~>[inventory​Activate](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryActivate) * <\~>[inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/2025-07/mutations/inventoryBulkToggleActivation) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node) interface *** ## ||-InventoryLevel Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-07/interfaces/Node)