--- title: InventoryItem - GraphQL Admin description: |- A [product variant's](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) inventory information across all locations. The inventory item connects the product variant to its [inventory levels](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) at different locations, tracking stock keeping unit (SKU), whether quantities are tracked, shipping requirements, and customs information for the product. Learn more about [inventory object relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships). api_version: unstable api_name: admin source_url: html: https://shopify.dev/docs/api/admin-graphql/unstable/objects/inventoryitem md: https://shopify.dev/docs/api/admin-graphql/unstable/objects/inventoryitem.md --- # Inventory​Item object Requires `read_inventory` access scope or `read_products` access scope. A [product variant's](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) inventory information across all locations. The inventory item connects the product variant to its [inventory levels](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) at different locations, tracking stock keeping unit (SKU), whether quantities are tracked, shipping requirements, and customs information for the product. Learn more about [inventory object relationships](https://shopify.dev/docs/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states#inventory-object-relationships). ## Fields * country​Code​Of​Origin [Country​Code](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CountryCode) The ISO 3166-1 alpha-2 country code of where the item originated from. * country​Harmonized​System​Codes [Country​Harmonized​System​Code​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/CountryHarmonizedSystemCodeConnection) non-null A list of country specific harmonized system codes. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) non-null The date and time when the inventory item was created. * duplicate​Sku​Count [Int!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Int) non-null The number of inventory items that share the same SKU with this item. * harmonized​System​Code [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) The harmonized system code of the item. This must be a number between 6 and 13 digits. * id [ID!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/ID) non-null A globally-unique ID. * inventory​History​Url [URL](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/URL) The URL that points to the inventory history for the item. * inventory​Level [Inventory​Level](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel) The inventory item's quantities at the specified location. * inventory​Levels [Inventory​Level​Connection!](https://shopify.dev/docs/api/admin-graphql/unstable/connections/InventoryLevelConnection) non-null A list of the inventory item's quantities for each location that the inventory item can be stocked at. * legacy​Resource​Id [Unsigned​Int64!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/UnsignedInt64) non-null The ID of the corresponding resource in the REST Admin API. * measurement [Inventory​Item​Measurement!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItemMeasurement) non-null The packaging dimensions of the inventory item. * province​Code​Of​Origin [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) The ISO 3166-2 alpha-2 province code of where the item originated from. * requires​Shipping [Boolean!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean) non-null Whether the inventory item requires shipping. * sku [String](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/String) Inventory item SKU. Case-sensitive string. * tracked [Boolean!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/Boolean) non-null Whether inventory levels are tracked for the item. * tracked​Editable [Editable​Property!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/EditableProperty) non-null Whether the value of the `tracked` field for the inventory item can be changed. * unit​Cost [Money​V2](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MoneyV2) Unit cost associated with the inventory item. Note: the user must have "View product costs" permission granted in order to access this field once product granular permissions are enabled. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/unstable/scalars/DateTime) non-null The date and time when the inventory item was updated. * variants [Product​Variant​Connection](https://shopify.dev/docs/api/admin-graphql/unstable/connections/ProductVariantConnection) A paginated list of the variants that reference this inventory item. * variant [Product​Variant!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ProductVariant) non-nullDeprecated *** ## Map ### Fields and connections with this object * {}[InventoryChange.item](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryChange#field-InventoryChange.fields.item) * <->[InventoryItemConnection.nodes](https://shopify.dev/docs/api/admin-graphql/unstable/connections/InventoryItemConnection#returns-nodes) * {}[InventoryItemEdge.node](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryItemEdge#field-InventoryItemEdge.fields.node) * {}[InventoryLevel.item](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryLevel#field-InventoryLevel.fields.item) * {}[InventoryShipmentLineItem.inventoryItem](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryShipmentLineItem#field-InventoryShipmentLineItem.fields.inventoryItem) * {}[InventoryTransferLineItem.inventoryItem](https://shopify.dev/docs/api/admin-graphql/unstable/objects/InventoryTransferLineItem#field-InventoryTransferLineItem.fields.inventoryItem) * {}[ProductVariant.inventoryItem](https://shopify.dev/docs/api/admin-graphql/unstable/objects/ProductVariant#field-ProductVariant.fields.inventoryItem) *** ## Queries * [inventory​Item](https://shopify.dev/docs/api/admin-graphql/unstable/queries/inventoryItem) query Returns an [InventoryItem](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) object by ID. * [inventory​Items](https://shopify.dev/docs/api/admin-graphql/unstable/queries/inventoryItems) query Returns a list of inventory items. *** ## \InventoryItem Queries ### Queried by * \[inventory​Item](https://shopify.dev/docs/api/admin-graphql/unstable/queries/inventoryItem) * \[inventory​Items](https://shopify.dev/docs/api/admin-graphql/unstable/queries/inventoryItems) *** ## Mutations * [inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/unstable/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). * [inventory​Item​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventoryItemUpdate) mutation Updates an [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem)'s properties including whether inventory is tracked, cost, SKU, and whether shipping is required. Inventory items represent the goods available to be shipped to customers. *** ## <\~> InventoryItem Mutations ### Mutated by * <\~>[inventory​Bulk​Toggle​Activation](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventoryBulkToggleActivation) * <\~>[inventory​Item​Update](https://shopify.dev/docs/api/admin-graphql/unstable/mutations/inventoryItemUpdate) *** ## Interfaces * * [Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/LegacyInteroperability) interface * [Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node) interface *** ## ||-InventoryItem Implements ### Implements * ||-[Legacy​Interoperability](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/LegacyInteroperability) * ||-[Node](https://shopify.dev/docs/api/admin-graphql/unstable/interfaces/Node)