Shopify Adds Canceled Receive Action to Inventory Shipments API

What Changed

Shopify’s GraphQL Admin API now supports a CANCELED receive action for inventory shipments, introduced in API version 2026-10. This addition allows developers to mark inventory shipment line item units as canceled when those units will never arrive at their destination.

The update also introduces the ability to read canceled quantities directly on shipment objects and their associated line items. This CANCELED action joins the existing ACCEPTED and REJECTED receive actions that were already part of the inventory shipments API, giving developers a more complete set of states for tracking shipment outcomes.

This is an additive change tied to the 2026-10 release candidate. Apps running on earlier API versions are not affected, and no immediate action is required for existing integrations.

Why This Matters for App Developers

Apps that manage inventory receiving, warehouse operations, or supply chain logistics for Shopify merchants now have a more accurate way to represent shipment discrepancies. Previously, developers working with inventory shipments could only mark units as accepted or rejected, which didn’t fully capture scenarios where inventory is confirmed lost, canceled by a supplier, or otherwise known to never arrive.

For apps built around inventory reconciliation, this reduces the need for workarounds like custom metafields or external tracking systems to flag canceled units.

Practical Implications

Developers building or maintaining inventory management apps should review their shipment receiving logic to determine whether adopting the CANCELED action improves accuracy in reporting and reconciliation workflows.

Since this change is scoped to API version 2026-10, teams should plan their upgrade timeline accordingly. Apps not yet on this version can continue operating without modification, but those planning migrations should account for the new receive action in their data models and shipment status handling.

Read the full announcement →