Inventory Item Sets

Inventory Item Sets Query

Returns a paginated list of InventoryItemSet objects, with optional filtering and ordering. Item sets allow grouping multiple inventory items together for collective operations.

Arguments

Name	Type	Description
after	Cursor	Returns the elements in the list that come after the specified cursor
first	Int	Returns the first n elements from the list
before	Cursor	Returns the elements in the list that come before the specified cursor
last	Int	Returns the last n elements from the list
orderBy	InventoryItemSetOrder	Ordering options for item sets returned from the connection
where	InventoryItemSetWhereInput	Filtering options for item sets returned from the connection

Return Type

InventoryItemSetConnection! - A connection to a list of InventoryItemSet objects with pagination information.

Notes

The data field contains custom item set attributes as JSON. You can use the Data, DataHasKey, DataIn, and DataContains filters to query based on JSON content. For complex JSON field queries, see Advanced JSON Field Queries.

Usage Example

query {
  # Search item sets by SKU
  inventoryItemSets(
    where: {
      skuContains: "BUNDLE"
    },
    orderBy: { direction: DESC, field: CREATED_AT }
  ) {
    edges {
      node {
        id
        sku
        dataTypeSlug
        data
        createdAt
        items {
          id
          sku
          data
        }
      }
      cursor
    }
    totalCount
  }
}

query {
  # Get item sets with specific data type
  inventoryItemSets(
    where: {
      dataTypeSlug: "product_bundle"
    },
    first: 20
  ) {
    edges {
      node {
        id
        sku
        dataTypeSlug
        data
        items {
          id
          sku
          inventoryJSONData
        }
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

query {
  # Get item sets that contain specific items
  inventoryItemSets(
    where: {
      hasItemsWith: [
        { skuContains: "COMP-001" }
      ]
    }
  ) {
    edges {
      node {
        id
        sku
        items {
          id
          sku
        }
      }
    }
  }
}

Common Filters

• skuContains - Search by item set SKU substring

• sku - Find by exact item set SKU

• dataTypeSlug - Filter by data type slug

• hasItems - Filter item sets that have items

• hasItemsWith - Filter by criteria on contained items

• createdAtGTE / createdAtLTE - Filter by creation date range

Notes

• Item sets represent grouped collections of inventory items

• Useful for managing product bundles, kits, or component sets

• Each item set has its own SKU for identification and tracking

• Support custom fields through data/dataType system

• Items in a set can be managed collectively for operations

• Enable complex inventory relationships and hierarchies