Developer changelog
Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases.
Tags:
- API
- 2023-10
UI extensions - the order status page is getting a new lookRead full post –>The order status page gets a new look, aligning with customer accounts. Rolled out progressively, no action needed. UI extensions remain unchanged.
Tags:
- API
New fields on Country Liquid objectRead full post –>Added
,continent, andpopular?to Liquid'scountryobject, enhancing localization and sorting in country selectors for improved theme flexibility.Tags:
- Tools
[Developer Preview] Mobile Checkout SDK for iOSRead full post –>Shopify launches iOS Mobile Checkout SDK Developer Preview. Offers customizable, high-conversion checkout with store customizations. Android SDK coming soon. APIs may change with feedback.
Tags:
- API
[Developer Preview] Cart Transform API - Pricing bundles per component & additional customizationsRead full post –>The Cart Transform API now supports fixed prices and custom titles/images for bundle components, enhancing control over bundle pricing and enabling add-on product bundles.
Tags:
- Shopify App Store
Display Business Imprint on Shopify's App Store and Theme StoreRead full post –>Starting October 11, 2023, Shopify's App Store and Theme Store will display the partner's geographical address and contact information in order to be in compliance with Business Imprint legal...
Tags:
- Shopify App Store
App Store listings are now automatically translated into 8 languagesRead full post –>English app listings are now auto-translated into 8 languages, boosting non-English market installs by 20%. Developers can enhance this by translating their app's UI.
Tags:
- Platform
Shopify Flow - Use dev command to preview tasks and use more complex data in triggersRead full post –>The
devcommand now supports Flow extensions, enabling complex data in triggers. Flow in CLI is generally available, requiring CLI v3.48+ anddevv3.49+ for full functionality.Tags:
- API
- 2023-10
Shopify Function configurations now use target identifiersRead full post –>API v2023-10 and Shopify CLI 3.49.5 introduce
targetingfor Shopify Functions, aligning them with app extensions. Upgrade CLI to 3.49.4+ to usetargeting. Existing functions remain unaffected.Tags:
- API
Shopify Functions now support localization of their name and descriptionRead full post –>Shopify Functions now support localization for names and descriptions, allowing translation into users' native languages. Upgrade Shopify CLI to 3.49.5+ to use this feature.
Tags:
- API
- 2023-10
New fields available for Shopify Functions input queriesRead full post –>API v2023-10 adds
shop,localization, andfields to Shopify Functions, enhancing access to shop data, localization, and currency rates for developers.Tags:
- API
- 2023-10
Updates to GraphQL Admin API for bundlesRead full post –>As of 2023-10, query
forto identify bundle variants. Apps can render custom UI on product pages by claiming bundle ownership.Tags:
- API
- 2023-10
New webhook topic added for Publication delete eventsRead full post –>As of API version 2023-10, a new webhook topic
PUBLICATIONS_DELETEis added. This webhook occurs whenever a publication is deleted and requires thescope.Tags:
- API
- 2023-10
serviceCode is available on the DeliveryMethod APIRead full post –>As of the { 2023-10 } API version, you can use { DeliveryMethod } to get the value of the { serviceCode } chosen for the related { FulfillmentOrder} . The { DeliveryMethod } object is now...
Tags:
- Action Required
- API
- 2023-10
Breaking change to metafieldDefinitionUpdate mutation: access input type changedRead full post –>GraphQL Admin API 2023-10 changes
type to, impacting apps usingfor access property updates.Tags:
- API
- 2023-10
Staff error as Order cancel reasonRead full post –>As of 2023-10, we have added
STAFFto theGraphQL type to serve as a reason for canceling orders due to staff errors.Learn more about
on...Tags:
- API
- 2023-10
Introducing explicit access grants for app-owned metafieldsRead full post –>GraphQL Admin API 2023-10 adds
grantsforREAD/READ_WRITEmetafield access, allowing up to 16 grants per definition. Note breaking change in.Tags:
- Action Required
- Shopify App Store
App Revenue Attribution Record API DepreciatedRead full post –>The App Revenue Attribution API is removed. Methods for creating and deleting records are unsupported. Use Google Analytics for tracking Shopify App Store Ads installs and related metrics.
Tags:
- API
Checkout branding is moving to stable, with an update on color settingsRead full post –>The Checkout Branding API now allows more color control. Use
instead of the deprecatedfor future updates.Tags:
- API
- 2023-10
payment_method_nameavailable in PaymentDetails GraphQL and REST APIs to check for Shop Pay Installments transactionsRead full post –>The
field is added to PaymentDetails GraphQL and Admin REST APIs for identifying Shop Pay Installments, replacing reliance ongatewayvalues starting January 2024.Tags:
- API
- 2023-10
New error code added for MetafieldDefinitionUpdateRead full post –>API v2023-10 introduces
METAOBJECT_DEFINITION_CHANGEDerror for updatingdefinitions, replacingINTERNAL_SERVER_ERROR, improving error specificity.Tags:
- Action Required
- API
- 2023-10
Changes to Subscription Billing Attempt creation behaviorRead full post –>The
mutation now restricts attempts based on fraud analysis, addingCONTRACT_UNDER_REVIEWerror code for blocked attempts in API 2023-10.Tags:
- API
- 2023-10
Manage Quantity Price Breaks for B2B CustomersRead full post –>As of the
2023-10version of the Admin GraphQL API, you can view thefor a product variant onand. Additionally, you will...Tags:
- API
- 2024-01
Subscriptions Support for Automatic DiscountsRead full post –>Added subscription options for automatic product discounts. From 2024-01, API will classify these as "AUTOMATIC_DISCOUNT" instead of "MANUAL".
Tags:
- API
- 2023-10
New field to query Order cancellationRead full post –>As of 2023-10, we've added a new field
cancellationtoOrdergraphQL object.This field can provide additional details about the order cancellation, such as staff provided notes on why the...
Tags:
- Action Required
- API
- 2023-10
Deprecation ofmetafield(id)queryRead full post –>As of 2023-10, the
metafield(id)query is no longer supported. Metafields should be queried via theconnection of metafield owners. If necessary, metafields can be queried by ID...Tags:
- Action Required
- API
- 2023-10
Simplify Metafield interaction with default namespacesRead full post –>From 2023-10, the Admin and Storefront GraphQL APIs make the namespace field optional for Metafields, simplifying app interactions by using a default namespace when unspecified.
Tags:
- Action Required
- API
- 2023-10
RemovingShop.shopifyPaymentsAccounton Admin APIRead full post –>As of
2023-10, we're removing the deprecatedfield. Use the...Tags:
- Action Required
- API
- 2023-10
Multiple domains on the primary marketRead full post –>API v2023-10: Markets API now supports multiple domains. New
added. Usefor updates/deletes. Add domains with.Tags:
- Action Required
- API
- 2023-10
Removal of Customer averageOrderAmount fields on Admin APIRead full post –>As of GraphQL Admin API version 2023-10, the following
Customerfields have been deprecated:,.Learn more about the
Customerobject on...Tags:
- Action Required
- API
- 2023-10
Making the primary market more flexibleRead full post –>As of 2023-10, you can customize the primary market in three new ways:
- The currency can be set to any currency independent of the merchant's shop currency.
- The country can be set...
Tags:
- API
- 2023-10
New compare-at price range field on Product APIRead full post –>As of version 2023-10 of the GrapqhQL Admin API, we've added the
field toProductwhich will return the minimum and maximum compare-at prices across a product's variants.Tags:
- API
- 2023-10
Cart Line Items Now Ordered in Reverse Chronological Order Based on Time of AdditionRead full post –>API v2023-10 changes cart item order: new items now appear at the top. Developers should check app functionality if it depends on item order in the cart.
Tags:
- Action Required
- API
- 2023-10
Apps can now change the name and address of their fulfillment service locationsRead full post –>In API 2023-10, apps can edit fulfillment service location names/addresses via LocationEdit. New errors: modifying fulfillsOnlineOrders is restricted; write_fulfillments scope is needed for edits.
Tags:
- API
- 2023-10
More information about the Order added to the FulfillmentOrder APIRead full post –>New fields
,,,added toobject. Access order data with fulfillment_orders scope, no read_orders scope needed.Tags:
- API
Storefront API now supports product bundlesRead full post –>Merchants using Hydrogen or Headless Channel can now offer bundles via Shopify. Create fixed bundles or multipacks with Shopify Bundles app or use APIs for custom bundles (Plus/Partners only).
Tags:
- API
POS UI extensions 1.4.0 update: new API, propsRead full post –>POS UI Extensions v1.4.0 adds Connectivity API, optional BadgeStatus and overrideNavigateBack props, and isDevice function, enhancing device info and UI control for developers.
Tags:
- Themes
Enhancements to range and select input settingsRead full post –>New updates enhance range and select inputs: range now supports sliders and input boxes for precision; select offers dropdowns or segmented controls for improved theme editing flexibility.
Tags:
- Themes
New input setting text_alignment launchedRead full post –>A new input setting of type text_alignment has been introduced, featuring an icon-based segmented control design.
The setting comes pre-built with default values
left,centerandright,...Tags:
- Themes
New Liquid section properties and default lazy loading for image tagsRead full post –>Default lazy loading for
is added for lower sections. New section properties allow customization and fix performance issues like above-the-fold lazy loading and async CSS shifts.Tags:
- API
- 2023-10
New GraphQL Admin API field CustomerAccountsV2 exposes shops' customer accounts settingsRead full post –>As of Admin GraphQL API version 2023-10, you can query the CustomerAccountsV2 field on the Shop object to get information about the shop's customer accounts settings. CustomerAccountsV2 will let...
Tags:
- Themes
Updates to the Theme Store RequirementsRead full post –>Shopify Theme Store now requires scripts to be hosted on Shopify servers, barring interference with native features, ensuring security and consistency.
Tags:
- API
- 2023-10
Cart validation errors on online store cart and Storefront APIRead full post –>As of Storefront GraphQL API version 2023-10, we’ve added the
VALIDATION_CUSTOMerror type toso that you can use validation errors in carts.Learn more about cart...
Tags:
- Tools
Admin action extensions are now generally availableRead full post –>Admin action extensions are now available, allowing seamless app integration into Shopify admin. They enhance efficiency by embedding workflows and offer direct API access for faster performance.
Tags:
- Shopify App Store
Full-funnel Google Analytics attributionRead full post –>New integration with Google Analytics provides app install event visibility and ties installs to Shop IDs, enhancing insights and comparison of Shopify App Store Ads performance.
Tags:
- Shopify App Store
Introducing homepage ads on the Shopify App StoreRead full post –>Developers can now generate more demand for your apps by showcasing them on the homepage of the Shopify App Store.
Learn more about homepage ads on our...
Tags:
- Tools
New APIs added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the Print,...
Tags:
- API
- 2023-10
Automatic free shipping discount now available on GraphQL Admin APIRead full post –>It is now possible to offer automatic free shipping discounts using the GraphQL Admin API using ...
Tags:
- Action Required
- API
- 2023-10
Removal of UsageCharge billing_on field on Admin REST APIRead full post –>As of Admin REST API version 2023-10, the following
fields have been deprecated:.Learn more about the
object on...Tags:
- Tools
Liquid Console: Test and evaluate Liquid snippets quickly using Shopify CLIRead full post –>Liquid Console now available via Shopify CLI for testing Liquid in your code editor, speeding up feedback, simplifying debugging, and aiding learning. Use
shopify theme consoleto start.Tags:
- Action Required
- API
- 2023-10
Breaking changes to ShopResourceLimits API: Deprecate "skuResourceLimits"Read full post –>As of GraphQL Admin API version 2023-10, we're deprecating the "skuResourceLimits" field from the
query object. We're no longer enforcing a limit of SKUs at a shop level....