Deprecated Region Fields, Variant Title Exclusions Removed, New Error Code

6/26/2026, 12:00:47 AM

This API release removes the input and object types for “CollectionSourceExclusionConditionVariantTitle” and its update input, eliminating the ability to filter collections by variant titles. The fields “code” and “country” on “MarketRegionProvince” and the fields “code” and “name” on “MarketRegionProvinceCountry” are now deprecated; use the corresponding fields on “MarketRegionSubdivision” and “MarketRegionSubdivisionCountry” instead. The enum values “INCOMPATIBLE_CONFIGURATION” have been added to the “CatalogUserErrorCode“, “DiscountErrorCode“, and “MarketUserErrorCode“ enums, so error handling must account for these new codes. The “priceRule” field has been removed from “DraftOrderDiscountNotAppliedWarning“, indicating that this warning no longer exposes a direct reference to the price rule. Developers should update any queries or mutations that reference the removed types or deprecated fields, adjust their error handling for the new “INCOMPATIBLE_CONFIGURATION” codes, and migrate to the subdivision-based region fields to maintain functionality.

Type Changes

➖ Removed Types (27)

📥CollectionSourceExclusionConditionUpdateVariantTitleInput➖ RemovedINPUT_OBJECT

The input fields for updating an exclusion condition based on variant titles.

🏗️CollectionSourceExclusionConditionVariantTitle➖ RemovedOBJECT

A condition based on variant titles for excluding products from a collection.

Fields: id, matchType, relation, values
📥CollectionSourceExclusionConditionVariantTitleInput➖ RemovedINPUT_OBJECT

The input fields for an exclusion condition based on variant titles.

📋CollectionSourceExclusionConditionVariantTitleRelation➖ RemovedENUM

The relation for comparing variant titles in exclusion conditions.

Values: EQUALS, CONTAINS
🏗️PriceRule➖ RemovedOBJECT

A set of conditions, including entitlements and prerequisites, that must be met for a discount code to apply.

Note:
Use the types and queries included our discount tutorials instead. These will replace the GraphQL Admin API's PriceRule object and DiscountCode union, and the REST Admin API's deprecatedPriceRule resource.

Fields: allocationLimit, allocationMethod, app, combinesWith, createdAt ... +32 more
📋PriceRuleAllocationMethod➖ RemovedENUM

The method by which the price rule's value is allocated to its entitled items.

Values: EACH, ACROSS
🏗️PriceRuleCustomerSelection➖ RemovedOBJECT

A selection of customers for whom the price rule applies.

Fields: customers, forAllCustomers, segments
🏗️PriceRuleDiscountCode➖ RemovedOBJECT

A discount code of a price rule.

Fields: app, code, id, usageCount
🏗️PriceRuleDiscountCodeConnection➖ RemovedOBJECT

An auto-generated type for paginating through multiple PriceRuleDiscountCodes.

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

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

Fields: cursor, node
🏗️PriceRuleEntitlementToPrerequisiteQuantityRatio➖ RemovedOBJECT

Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items.

Fields: entitlementQuantity, prerequisiteQuantity
📋PriceRuleFeature➖ RemovedENUM

The list of features that can be supported by a price rule.

Values: BUY_ONE_GET_ONE, BUY_ONE_GET_ONE_WITH_ALLOCATION_LIMIT, BULK, SPECIFIC_CUSTOMERS, QUANTITY_DISCOUNTS
🏗️PriceRuleFixedAmountValue➖ RemovedOBJECT

The value of a fixed amount price rule.

Fields: amount
🏗️PriceRuleItemEntitlements➖ RemovedOBJECT

The items to which this price rule applies. This may be multiple products, product variants, collections or combinations of the aforementioned.

Fields: collections, productVariants, products, targetAllLineItems
🏗️PriceRuleLineItemPrerequisites➖ RemovedOBJECT

Single or multiple line item products, product variants or collections required for the price rule to be applicable, can also be provided in combination.

Fields: collections, productVariants, products
🏗️PriceRuleMoneyRange➖ RemovedOBJECT

A money range within which the price rule is applicable.

Fields: greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo
🏗️PriceRulePercentValue➖ RemovedOBJECT

The value of a percent price rule.

Fields: percentage
🏗️PriceRulePrerequisiteToEntitlementQuantityRatio➖ RemovedOBJECT

Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items.

Fields: entitlementQuantity, prerequisiteQuantity
🏗️PriceRuleQuantityRange➖ RemovedOBJECT

A quantity range within which the price rule is applicable.

Fields: greaterThan, greaterThanOrEqualTo, lessThan, lessThanOrEqualTo
🏗️PriceRuleShareableUrl➖ RemovedOBJECT

Shareable URL for the discount code associated with the price rule.

Fields: targetItemImage, targetType, title, url
📋PriceRuleShareableUrlTargetType➖ RemovedENUM

The type of page where a shareable price rule URL lands.

Values: HOME, PRODUCT, COLLECTION
🏗️PriceRuleShippingLineEntitlements➖ RemovedOBJECT

The shipping lines to which the price rule applies to.

Fields: countryCodes, includeRestOfWorld, targetAllShippingLines
📋PriceRuleStatus➖ RemovedENUM

The status of the price rule.

Values: ACTIVE, EXPIRED, SCHEDULED
📋PriceRuleTarget➖ RemovedENUM

The type of lines (line_item or shipping_line) to which the price rule applies.

Values: LINE_ITEM, SHIPPING_LINE
📋PriceRuleTrait➖ RemovedENUM

The list of features that can be supported by a price rule.

Values: BUY_ONE_GET_ONE, BUY_ONE_GET_ONE_WITH_ALLOCATION_LIMIT, BULK, SPECIFIC_CUSTOMERS, QUANTITY_DISCOUNTS
🏗️PriceRuleValidityPeriod➖ RemovedOBJECT

A time period during which a price rule is applicable.

Fields: end, start
🔀PriceRuleValue➖ RemovedUNION

The type of the price rule value. The price rule value might be a percentage value, or a fixed amount.

🔄 Modified Types (6)

🏗️CatalogUserErrorCode🔄 Modified
Enum value added: INCOMPATIBLE_CONFIGURATION
🏗️DiscountErrorCode🔄 Modified
Enum value added: INCOMPATIBLE_CONFIGURATION
🏗️DraftOrderDiscountNotAppliedWarning🔄 Modified
Field removed: priceRule
🏗️MarketRegionProvince🔄 Modified
🔄 Field modified: code
🔄 Field modified: country
🏗️MarketRegionProvinceCountry🔄 Modified
🔄 Field modified: code
🔄 Field modified: name
🏗️MarketUserErrorCode🔄 Modified
Enum value added: INCOMPATIBLE_CONFIGURATION