New payment decline codes added to `OrderTransactionErrorCode` enum
We're adding new error codes to the OrderTransactionErrorCode enum to provide more granular detail about the transaction failure. You can use this more detailed response to improve customer interactions. What's new These error codes enable precise identification of transaction issues: | Error Code | Description | |
Also shipped Mar 16, 2026Shopify in March 2026 →
🤖 New LLM Models Support & Bug Fixes
We've added support for new LLM models in the Voice Agent API: OpenAI GPT-5.3 Instant ( gpt-5.3-chat-latest ) OpenAI GPT 5.4 ( gpt-5.4 ) Google Gemini 3.1 Flash Lite ( gemini-3.1-flash-lite-preview ) Example: { "type": "Settings", "agent": { "think": { "provider": { "type": "open_ai", "model": "gpt-5.3-chat-latest" } } } } For the full list of supported...
Metrics Open Beta Now Supports Alerting
Metrics, currently in open beta, now support creating alerts.
Persisting Table Filter in URL & Persisting Collapsed Card State in Experiment/Flags UI
What it is: Two state persistence improvements for Experiment and Feature Flags. Experiment table filters now encode into the URL, so filtering by status, tag, or owner produces a link you can bookmark or send to a teammate.
Targeting based on First Seen Timestamp
What it is: A built-in "First Seen" user property is now available in Guides and Surveys' remote evaluation. Cohort-based new user targeting has a reliability problem: membership updates run with a delay, so a brand-new user won't be included until after their first session has already passed.
Release of Mistral Small 4
Mistral Small 4 (mistral-small-2603) is a hybrid model that unifies instruct, reasoning, and coding capabilities in a single multimodal model with a 256k context window.
Release of Leanstral Code Agent
Leanstral (labs-leanstral-2603) is an open-source code agent designed for Lean 4 formal proof engineering.
More from Shopify developer platformEvery Shopify developer platform release →
Making `fieldDefinitions` optional in `metaobjectDefinitionCreate`
Starting in April 2026, the fieldDefinitions input argument for the metaobjectDefinitionCreate mutation will become optional. This change means that developers will no longer be required to specify fieldDefinitions when creating a new metaobject definition.
Adding `createdAt` and `updatedAt` fields to `MetaobjectDefinition` objects
The createdAt and updatedAt fields will become available on MetaobjectDefinition objects in API version 2026-04
New rejection reason codes in Payments Apps API
The Payments Apps API now provides more granular decline reason codes for rejected payment sessions. Multiple new rejection codes have been added to the PaymentSessionStateRejectedReason enum alongside a new source field, giving payments apps more standardized, actionable ways to communicate to merchants why a payment was declined.
POS UI extensions can now run without network access
POS UI extensions can now continue running even when a merchant’s device loses network access. This feature ensures uninterrupted service during connectivity issues. It is especially beneficial for merchants in environments with unreliable internet, such as pop-up shops, outdoor markets, or large retail spaces.
`inventoryTransferDelete` adds `INVALID_STATE` error code for transfers with in-progress product import
Starting in version 2026-07, the inventoryTransferDelete mutation will return a new error code: INVALID_STATE . This error will be returned when a client attempts to delete an inventory transfer while a product import related to that transfer is in progress.
ShopifyQL returns fields deprecated and replaced with sales reversals fields
In GraphQL Admin API version 2026-04 , several Returns fields in analytics, which can be queried through ShopifyQL , have been deprecated and replaced with renamed versions (e.g., sales_reversals , reversed_quantity ) to better reflect that they capture all order adjustments, including refunds, returns, order edits, and cancellations.
Checkout and Customer Account UI extensions available by default in new development shops
We are ending the developer preview for checkout and customer account UI extensions. With this update: All new development shops on the Shopify Plus plan have access to checkout UI extensions All new development shops on all plans have access to customer account UI extensions All existing development shops will not be affected by this change
Expiring offline access tokens required for new public apps as of April 1, 2026
We're updating how public apps handle offline access tokens to enhance merchant data protection. Starting April 1, 2026, all new public apps must request and use expiring offline access tokens .