9/19/2026, 12:00:52 AM
New root queries marketRelationships and marketRelationshipsStatus now expose the parent/child graph of all markets in the store, along with a status object that lets clients tell when that graph changes. Corresponding types MarketRelationship, MarketRelationshipConnection, and MarketRelationshipsStatus have been added, and the Market type gains childMarkets, childMarketsCount, parentMarkets, and parentMarketsCount fields to walk the hierarchy. The older automaticDiscounts query has been removed in favor of the newer automaticDiscountNodes endpoint, so update any code that fetched automatic discounts via the old query. Inventory management primitives are being simplified; InventoryBinItemQuantity, InventoryBinItemQuantityConnection, and InventoryBinItemQuantityEdge were removed and the InventoryBin type no longer exposes inventoryBinItemQuantities. Several other refinements made the API more consistent: AuditTrailAdjustment.label now warns against using its value for business logic, RolloutTreatment.changes filtering syntax was extended, and a new CURRENCY_CONVERSION value was added to ShopifyPaymentsTransactionType. SubscriptionContractCalculationDiagnostic.field was clarified to reference the calculated contract rather than input fields, ensuring diagnostics point to the correct location.
The relationships between all markets in the shop.
The state of the shop's market relationships.
Returns a list of automatic discounts that are applied in the cart and at checkout without requiring a discount code.
Represents a parent/child relationship between two markets.
An auto-generated type for paginating through multiple MarketRelationships.
An auto-generated type which holds one MarketRelationship and a cursor during pagination.
The state of the shop's market relationships, which are the parent and child relationships between the shop's markets. The relationships are rebuilt asynchronously after a market, market condition, or market region changes.
An auto-generated type for paginating through multiple DiscountAutomatics.
An auto-generated type which holds one DiscountAutomatic and a cursor during pagination.
The quantity of an inventory item stored in a bin.
Note:
This object is available only in the unstable API version and to development stores
that have enabled the Physical inventory feature preview.
An auto-generated type for paginating through multiple InventoryBinItemQuantities.
An auto-generated type which holds one InventoryBinItemQuantity and a cursor during pagination.
labelinventoryBinItemQuantitieschildMarketsThe market's direct children. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.
childMarketsCountThe number of direct child markets. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.
parentMarketsThe market's direct parents. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.
parentMarketsCountThe number of direct parent markets. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.
changesCURRENCY_CONVERSIONfield