Releasesby Glyph
Create unpaid orders from subscription billing attempts
In the API 2026-04 release candidate version, you can now include a new field called paymentProcessingPolicy when creating a billing attempt using the subscriptionBillingAttemptCreate mutation. A billing attempt is an action to charge a customer based on their subscription.
Also shipped Apr 1, 2026Shopify in April 2026 →
Revamped query editor experience
We’ve redesigned the query editor to make complex panels easier to build and manage. The new experience provides a unified view of your entire data pipeline, queries, expressions, transformations, and related alerts, with clearer visual feedback and faster access to the settings that matter.
New thought_signature field for Gemini function calling
The Voice Agent API now includes an optional thought_signature field in function call messages. Some Gemini models (3.0 and 3.1 families) require this as an additional function call identifier.
Example
{ "type": "FunctionCallRequest", "functions": [ { "id": "fc_12345678-90ab-cdef-1234-567890abcdef", "name": "get_weather", "arguments": "{\"location\": \"Fremont, CA 94539\"}", "client_side": true, "thought_signature": "abc123" } ] } The thought_signature field is optional and only relevant when using Google Gemini models.
New volume parameter for Cartesia TTS
The Voice Agent API now supports an optional agent.speak.provider.volume parameter when using Cartesia as the TTS provider. Valid values range from 0.5 to 2.0 . For more details, see Configure the Voice Agent or the Cartesia volume, speed, and emotion documentation .
More from Shopify developer platformEvery Shopify developer platform release →
Add Prerequisites to Product Discount Functions
Discount functions now support prerequisites for product discount candidates, allowing you to define the "Buy X" portion of a Buy X, Get Y (BXGY) discount. In a BXGY discount, customers must purchase a specified quantity of one product (Buy X) to receive a discount on another product (Get Y).
Add Tags to Discounts
Starting in API version 2026-04, discounts support tags allowing you to efficiently label, group, and organize your discounts. What's new: The tags field has been added to all discount types Tags can be added, updated, and removed via the Admin API For more information, visit the Admin API documentation
`expiresIn` field added to `DelegateAccessToken` type
We have introduced an expiresIn field to the DelegateAccessToken type, which is returned by the delegateAccessTokenCreate mutation. This addition allows app developers using delegate tokens to know precisely when their tokens will expire.
Adding access field to StandardMetaobjectDefinitionTemplate
We are introducing a new access field to the StandardMetaobjectDefinitionTemplate . This field will display the template's access rules, helping you determine if a specific template is configured for access via the Storefront API.
App-owned metaobjects can be used without access scopes
App-owned metaobjects, identified by types such as $app:example , including those created using declarative metaobject definitions , can now be utilized by their owning app without requiring any access scopes.
Removing outdated Polaris reference docs
Polaris reference docs now follow the same versioning policy as Shopify's GraphQL APIs: Each stable version is supported for a minimum of 12 months. Older versions continue to work, they just won’t have dedicated docs on Shopify.dev.
Metaobject access in Shopify Functions
As of GraphQL API version 2026-04, all Shopify Functions can access app-owned metaobject entries. Metaobjects are now available for every function target. This feature enables you to query additional structured data present in metaobjects, such as tiered pricing and bundles. To query a metaobject entry, specify a handle or ID in your input query file.
Metafield translations now available via GraphQL Admin API
The Metafield type now includes a translations field, enabling you to query localized metafield values directly via the GraphQL Admin API. This enhancement allows you to access translations for metafields associated with any resource, including products, collections, customers, orders, locations, and more.