Market Relationships, Discount Node Swap, Inventory Bin Removal

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.

Query Changes

➕ Added Queries (2)

marketRelationships

The relationships between all markets in the shop.

marketRelationshipsStatus

The state of the shop's market relationships.

➖ Removed Queries (1)

automaticDiscountsdeprecated

Returns a list of automatic discounts that are applied in the cart and at checkout without requiring a discount code.

Type Changes

➕ Added Types (4)

🏗️MarketRelationship➕ AddedOBJECT

Represents a parent/child relationship between two markets.

Fields: childMarket, id, parentMarket
🏗️MarketRelationshipConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple MarketRelationships.

Fields: edges, nodes, pageInfo
🏗️MarketRelationshipEdge➕ AddedOBJECT

An auto-generated type which holds one MarketRelationship and a cursor during pagination.

Fields: cursor, node
🏗️MarketRelationshipsStatus➕ AddedOBJECT

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.

Fields: version

➖ Removed Types (5)

🏗️DiscountAutomaticConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple DiscountAutomatics.

Fields: edges, nodes, pageInfo
🏗️DiscountAutomaticEdge➖ RemovedOBJECT

An auto-generated type which holds one DiscountAutomatic and a cursor during pagination.

Fields: cursor, node
🏗️InventoryBinItemQuantity➖ RemovedOBJECT

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.

Fields: inventoryBin, inventoryItem, quantity
🏗️InventoryBinItemQuantityConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple InventoryBinItemQuantities.

Fields: edges, nodes, pageInfo
🏗️InventoryBinItemQuantityEdge➖ RemovedOBJECT

An auto-generated type which holds one InventoryBinItemQuantity and a cursor during pagination.

Fields: cursor, node

🔄 Modified Types (6)

🏗️AuditTrailAdjustment🔄 Modified
🔄 Field modified: label
🏗️InventoryBin🔄 Modified
Field removed: inventoryBinItemQuantities
🏗️Market🔄 Modified
Field added: childMarkets

The market's direct children. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.

Field added: childMarketsCount

The number of direct child markets. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.

Field added: parentMarkets

The market's direct parents. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.

Field added: parentMarketsCount

The number of direct parent markets. Eventually consistent following a change in market hierarchy. See marketRelationshipsStatus.

🏗️RolloutTreatment🔄 Modified
🔄 Field modified: changes
🏗️ShopifyPaymentsTransactionType🔄 Modified
Enum value added: CURRENCY_CONVERSION
🏗️SubscriptionContractCalculationDiagnostic🔄 Modified
🔄 Field modified: field