Skip to main content
object

Requires read_inventory access scope. Also: The shop must have access to the physical inventory feature preview.

A physical container (bin) at a location where inventory is stored.


Note

This object is available only in the unstable API version and to development stores that have enabled the Physical inventory feature preview.


•String

The barcode of the bin. Unique within its location when present.

•ID!
non-null

A globally-unique ID.

•InventoryBinItemConnection

A paginated list of the inventory items stored in this bin and their quantities.

Show fields

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Show filters
Anchor to bin_name
•string

Filter by the bin name.

Example:

  • bin_name:"Aisle 1"
Anchor to is_available_for_sale
•boolean

Filter by whether inventory in the bin is available for sale.

Example:

  • is_available_for_sale:true
Anchor to is_default_bin
•boolean

Filter by whether the bin is the default bin for its location.

Example:

  • is_default_bin:false
Anchor to quantity
•integer

Filter by the on-hand quantity of the inventory item in the bin.

Example:

  • quantity:0
  • quantity:>10
Anchor to updated_at
•time

Filter by when the on-hand quantity of the inventory item in the bin last changed.

Example:

  • updated_at:>2025-01-01
•Boolean
Default:false

Reverse the order of the underlying list.

•InventoryBinItemSortKeys
Default:BIN_NAME

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

Show enum values

•Boolean!
non-null

Whether inventory in the bin is available for sale.

•Boolean!
non-null

Whether the bin is the default bin for its location.

•String!
non-null

The name of the bin. Unique within its location.

•String

A note about the bin.


Was this section helpful?

•mutation

Creates, updates and deletes inventory bins in a single atomic operation. If any operation fails, no changes are applied.


Note

This mutation is available only in the unstable API version and to development stores that have enabled the Physical inventory feature preview.


Show payload

Arguments

•[InventoryBinsEditInput!]!
required

The bin operations to apply. Each entry is exactly one of create, update or delete.

Show input fields


Was this section helpful?

•interface

Was this section helpful?