Skip to main content

New Pricing audit trail for contextual product variant prices

The GraphQL Admin API now includes the auditTrail field on ProductVariantContextualPricing in API version 2026-10.

Apps with the read_products access scope can use this field to inspect the ordered adjustments that Shopify applied to a contextual product variant price.

Existing apps do not need to take action.

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.
  • price: The price after Shopify applied the adjustment.
  • label: A localized, human-readable description of the adjustment.

Apps should treat label as display text. Its value can be localized or changed, so apps should not parse it or use it as a stable identifier.

This first release of the pricing audit trail supports product variant contextual pricing. It does not include audit trails for order line items or draft order line items.

If Shopify cannot return a complete and correct audit trail, priceAdjustments returns an empty list instead of a partial result.

Who's 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.

Existing apps are not affected unless they choose to query the new field. The change does not modify the existing ProductVariantContextualPricing.price or ProductVariantContextualPricing.compareAtPrice fields.

Why this matters

Apps can inspect the calculation that produced a contextual price. ERP and B2B integrations can use this information to explain adjustments from price lists, currency conversion, taxes, fees, and rounding.

The audit trail explains the price calculation. It does not identify the market, catalog, or price list that Shopify selected.

What to do

No action is required for existing apps.

To use the pricing audit trail:

  1. Use GraphQL Admin API version 2026-10 or later.
  2. Confirm that the app has the read_products access scope.
  3. Add auditTrail and priceAdjustments to a contextual pricing query.
  4. Test the query with a product variant that has contextual price adjustments.

A successful response returns the applicable adjustments in calculation order. An empty priceAdjustments list means that Shopify does not return a complete public audit trail for that price.

Related docs

Was this page helpful?