---
title: InventoryLevel - GraphQL Admin
description: |-
  The quantities of an inventory item that are related to a specific location.
  Learn [more about the relationships between inventory objects](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships).
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel.md
---

# Inventory​Level

object

Requires `read_inventory` access scope.

The quantities of an inventory item that are related to a specific location. Learn [more about the relationships between inventory objects](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/latest/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/latest/scalars/DateTime)

  non-null

  The date and time when the inventory level was created.

* deactivation​Alert

  [String](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/scalars/ID)

  non-null

  A globally-unique ID.

* item

  [Inventory​Item!](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem)

  non-null

  Inventory item associated with the inventory level.

* location

  [Location!](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location)

  non-null

  The location associated with the inventory level.

* quantities

  [\[Inventory​Quantity!\]!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/connections/InventoryScheduledChangeConnection)

  non-null

  Scheduled changes for the requested quantity names.

* updated​At

  [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/objects/InventoryItem#field-InventoryItem.fields.inventoryLevel)
* {}[InventoryItem.inventoryLevels](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem#field-InventoryItem.fields.inventoryLevels)
* <->[InventoryLevelConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/InventoryLevelConnection#returns-nodes)
* {}[InventoryLevelEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevelEdge#field-InventoryLevelEdge.fields.node)
* {}[InventoryScheduledChange.inventoryLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryScheduledChange#field-InventoryScheduledChange.fields.inventoryLevel)
* {}[Location.inventoryLevel](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location#field-Location.fields.inventoryLevel)
* {}[Location.inventoryLevels](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location#field-Location.fields.inventoryLevels)

***

## Queries

* [inventory​Level](https://shopify.dev/docs/api/admin-graphql/latest/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/latest/queries/inventoryLevel)

***

## Mutations

* [inventory​Activate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryActivate)

  mutation

  Activate an inventory item at a location.

* [inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryBulkToggleActivation)

  mutation

  Modify the activation status of an inventory item at locations. Activating an inventory item at a particular location allows that location to stock that inventory item. Deactivating an inventory item at a location removes the inventory item's quantities and turns off the inventory item from that location.

***

## <\~> InventoryLevel Mutations

### Mutated by

* <\~>[inventory​Activate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryActivate)
* <\~>[inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/inventoryBulkToggleActivation)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-InventoryLevel Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)