- Idempotency directive is now mandatory for a list of inventory and refund mutations in version 2026-04; calls without @idempotent will error at runtime.
- Developers must add @idempotent(key:"<UUID>") to these mutations to prevent duplicate adjustments and refunds and to enable safe retries.
- New error codes IDEMPOTENCY_CONCURRENT_REQUEST and IDEMPOTENCY_KEY_PARAMETER_MISMATCH are introduced for idempotency key misuse.
Making idempotency mandatory for inventory adjustments and refund mutations
Official Shopify changelog summary with source attribution, release tags, and community reactions.
Track this Shopify release note alongside related changelog updates, risky changes, and weekly digest signals from the developer community.
Verify the original release note
Every summary should remain traceable to the original changelog or release source.
Follow this in context
Turn this Shopify release note into a weekly digest for the tools you actually use.
Create digestMore Shopify changelog updates
admin.app.intent.link intents now open as a full‑page navigation instead of an overlay modal
Adds cart session attribution and cart attributes for richer checkout data.
Added the `shop_campaign_insights` schema to ShopifyQL, letting apps query campaign performance data using the existing `shopifyqlQuery` field with the `read_reports` scope.