9/15/2026, 12:00:26 AM
The GraphQL metaobjects query now expects the type argument to match an existing metaobject definition and for app‑owned types you must prepend $app: (e.g., $app:author).
The inventoryActivate mutation has removed the obsolete stockAtLegacyLocation argument and, starting with version 2026‑04, requires callers to supply an idempotency key via the @idempotent directive (it was optional in 2026‑01).
New audit‑trail types – AuditTrailAdjustment, AuditTrailAdjustmentType, and PricingAuditTrail – have been added and now appear on ProductVariantContextualPricing.auditTrail to explain how a price was computed.
A non‑nullable translatable Boolean field was added to the Metafield type to indicate whether the value can be translated.
The Product.requiresSellingPlan field’s description has been corrected to state that setting it to true makes a product subscription‑only and will unpublish it from all channels except the online store.
Existing applications should update query patterns for metaobjects, remove use of the legacy argument in inventory activation, add idempotency keys to that mutation, and review any price‑audit logic that may now be exposed through the new types.
Developers using metafields should check the new translatable flag to determine whether translation support is enabled.
Returns a paginated list of Metaobject entries for a specific type. Metaobjects are custom data structures that extend Shopify's data model with merchant or app-specific data types.
Filter results using the query parameter with a search syntax for metaobject fields. Use fields.{key}:{value} to filter by field values, supporting any field previously marked as filterable.
Results are ordered by metaobject ID in ascending order by default. The sortKey parameter accepts id, type, updated_at, or display_name to control result ordering. Pass reverse: true to invert the order.
Learn more about querying metaobjects by field value.
Activates an inventory item at a Location by creating an InventoryLevel that tracks stock quantities. This enables you to manage inventory for a ProductVariant at the specified location.
When you activate an inventory item, you can set its initial quantities. The available argument sets the quantity that's available for sale. onHand argument sets the total physical quantity at the location. If you don't specify quantities, then available and onHand default to zero.
Caution:
As of version2026-01, this mutation supports an optional idempotency key using the@idempotentdirective.
As of version2026-04, the idempotency key is required and must be provided using the@idempotentdirective.
For more information, see the idempotency documentation.
Learn more about managing inventory quantities and states.
One of a sequence of adjustments applied to determine a price.
The possible types of an adjustment applied to determine a price.
A record of how a particular price was determined.
translatableWhether the metafield's value can be translated. This is true when the metafield's
type
is translatable and its owner allows metafield translations.
requiresSellingPlanauditTrailThe record of how the price was determined.