New Pricing audit trail for contextual product variant prices
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 17, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-10.
What changed
The new ProductVariantContextualPricing.auditTrail field returns a PricingAuditTrail object. Its priceAdjustments field contains the adjustments in the order that Shopify applied them. Each AuditTrailAdjustment includes: type: The operation Shopify applied. The field returns an AuditTrailAdjustmentType value of ADDITION, MULTIPLICATION, or REPLACEMENT. value: The value used by the operation.
Who is affected
This change applies to apps that use GraphQL Admin API version 2026-10 or later and need to explain how Shopify calculated a contextual product variant price. The read_products access scope allows apps to query ProductVariantContextualPricing.auditTrail. Apps using API versions before 2026-10 cannot query the field.
What action may be needed
No action is required for existing apps. To use the pricing audit trail: Use GraphQL Admin API version 2026-10 or later. Confirm that the app has the read_products access scope. Add auditTrail and priceAdjustments to a contextual pricing query.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →