---
title: >-
  Add includeInactive argument to inventoryLevels and inventoryLevel fields -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/add-includeinactive-argument-to-inventorylevels-and-inventorylevel-fields
  md: >-
    https://shopify.dev/changelog/add-includeinactive-argument-to-inventorylevels-and-inventorylevel-fields.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-03-16T17:13:24-04:00'
  postedAt: '2026-04-17T12:00:00-04:00'
  updatedAt: '2026-04-01T22:20:07-04:00'
  effectiveAt: '2026-03-17T12:00:00-04:00'
---

April 17, 2026

Tags:

* Admin GraphQL API
* 2026-04

# Add `includeInactive` argument to `inventoryLevels` and `inventoryLevel` fields

As of API version 2026-04, you can pass `includeInactive: true` when querying the `inventoryLevels` or [`inventoryLevel`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryLevel) fields on [`InventoryItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/InventoryItem) and [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) to include inactive inventory levels in the response. By default, only active inventory levels are returned.

### Why we made this change

Previously, there was no way to retrieve inactive inventory levels through the API. The `includeInactive` argument gives apps explicit control over whether inactive levels are included in results.

### Impact on your app

* GraphQL: In the 2026-04 and later API versions, the fields [`InventoryItem.inventoryLevels`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/InventoryItem#field-InventoryItem.fields.inventoryLevels), [`InventoryItem.inventoryLevel`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/InventoryItem#field-InventoryItem.fields.inventoryLevel), [`Location.inventoryLevels`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/Location#field-Location.fields.inventoryLevels), and [`Location.inventoryLevel`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/Location#field-Location.fields.inventoryLevel) accept a new optional `includeInactive` boolean argument. The default is false, ensuring existing queries remain unaffected.

### What you need to do

* No changes are required for existing queries, as they will continue to return only active inventory levels.
* To access inactive inventory levels, include `includeInactive: true` in your queries.