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-04
AddscomparedTofield to ShopifyQL query responseRead full post –>As of 2023-04, you can now use
on comparison columns fromto indicate the column to compare to.Learn more about
ShopifyQL queries on...Tags:
- Action Required
- API
- 2023-04
ChangingCartLinefrom anObjectto anInterfaceRead full post –>As part of the GraphQL Storefront API 2023-04 API release, we are creating
as an interface toand we are updatingto....
Tags:
- Action Required
- API
- 2023-04
DeprecatingPublishedTranslationGraphQL typeRead full post –>As of
2023-04, we are deprecating thegraphQL type in the admin API. Use theTranslationgraphQL type instead.The
TranslationgraphQL type contains more fields;...Tags:
- API
- 2023-04
Addedsource_locationfield toFulfillmentOrdersMovewebhook payloadRead full post –>API v2023-04:
webhook addsfield. Use it to track original location afterchanges during move operations.Tags:
- API
- 2023-04
productVariantsBulkUpdate mutation returns data along with errorsRead full post –>In the Admin GraphQL API version 2023-04, the
mutation will returnproductanddata even when errors are present. Previously, the mutation would...Tags:
- API
- 2023-04
Filter orders by return statusRead full post –>Filter orders by return status using the new
filter in the orders connection, aligning with the return status seen on the merchant orders page.Tags:
- API
- 2023-04
Releasing new Catalogs APIs to manage pricing and product publishing for different customersRead full post –>API version 2023-04 introduces Catalogs API for setting product rules and prices by context, linking Shopify Markets and B2B features to customize offerings and manage sales channel publishing.
Tags:
- API
- 2023-04
Update ShopifyQL parse error codesRead full post –>Updated parse error codes enum: added 6 new codes and removed 10 outdated ones, improving error handling and clarity for developers.
Tags:
- Action Required
- API
- 2023-04
Updates to FulfillmentOrderLineItemsPreparedForPickupUserErrorCode resourceRead full post –>As of the 2023-04 API version of the Admin API, [the FulfillmentOrderLineItemsPreparedForPickupUserErrorCode GraphQL...
Tags:
- API
- 2023-04
Adding additional filtering to/assigned_fulfillment_ordersREST endpointRead full post –>API v2023-04 adds
filter tofor retrieving unrequested fulfillment orders assigned to app-owned locations.Tags:
- API
- 2023-04
Update validations of a metafield definitionRead full post –>GraphQL Admin API v2023-04 adds
for updating metafield validations andfor querying validation job details.Tags:
- API
- 2023-04
Web Pixels can be queried without specifying an IDRead full post –>In the Admin API version 2023-04, you can now query your web pixels installed on an online store without having to provide a Web Pixel ID.
API:...
Tags:
- API
- 2023-04
Accept customer address id as input for delivery address preferences in SFAPI CartRead full post –>As of April 2023, developers can use Customer address ID for CartBuyerIdentity.deliveryAddressPreferences in cart operations for authenticated users, enhancing address management.
Tags:
- API
- 2023-04
Add Metafields to Cart APIRead full post –>GraphQL Storefront API 2023-04 now supports Metafields with Carts. Developers can create, query, update, and delete Metafields during Cart operations.
Tags:
- API
- 2023-04
GraphQL Admin API now supports creating app charges using the merchant's billing currencyRead full post –>The 2023-04 GraphQL Admin API update lets developers create app charges in the merchant's local currency, reducing exposure to exchange rate fluctuations. Use shopBillingPreferences to get currency info.
Tags:
- API
- 2023-07
ExchangeV2s field is available behind beta flag on order graphqlRead full post –>As of 2023-07 version, you can use the Order APIs
field to get a better exchange (anobject value).This will help ERP partners to properly integrate optimal...
Tags:
- Shopify App Store
Update to Google Analytics 4 before July 2023Read full post –>Google is replacing Universal Analytics with GA4 in July 2023. Data remains accessible for 6 months post-sunset. Migrate app tracking to GA4 for continued analytics.
Tags:
- Themes
Dynamic sources for blogs and articles now liveRead full post –>You can now use dynamic sources on blogs and articles. This means that merchants can now connect theme files to their metafields and metaobjects when working with the blog and article resources....
Tags:
- API
- 2023-04
Additional fees fields for OrdersRead full post –>API v2023-04 adds fields for additional fees to Order objects in both GraphQL and REST, impacting cost calculations for international packages.
Tags:
- Shopify App Store
Policies for leaving a review on the Shopify App StoreRead full post –>We've enhanced our system to better detect and remove fake reviews. Developers may receive notifications if a review is removed for policy non-compliance.
Tags:
- Action Required
- API
- 2022-04
Support For API Version 2022-04 Extended To June 30, 2023Read full post –>Shopify extends API v2022-04 support to June 30, 2023. Migrate apps to v2022-10+ by then to avoid disruptions. Deprecated: certain order properties, Fulfillment API endpoints.
Tags:
- Action Required
- API
- 2022-04
[Action Required] Support for API version 2022-04 extended to June 30, 2023Read full post –>Shopify extends API 2022-04 support to June 30, 2023. Migrate apps to API 2022-10+ by then to avoid disruptions. Deprecated: certain customer properties, Fulfillment API endpoints.
Tags:
- API
- 2023-04
Access image Focal Point from the Storefront APIRead full post –>Access
Focal Pointsettings forMedia Presentationviain Storefront API. SetFocal Pointsin shop admin when editing images.Tags:
- API
- 2023-04
Read 3D model configuration settings from the Storefront APIRead full post –>As of
2023-04we're introducing the ability to read presentation attributes for 3D models in the storefront api.When a 3D model is customized via the no code 3D viewer configuration the...
Tags:
- Action Required
- API
- 2023-04
Removal ofcontextRuleon PriceListRead full post –>Starting in API version
2023-04, thefield will be removed and deprecated in previous API versions. If you have an existing app that uses thefield, then you...Tags:
- Shopify App Store
Geotargeting for Shopify App Store adsRead full post –>As of March 15, you can geotarget Shopify App Store advertising campaigns, giving greater control over how you market your apps and grow your business. Create effective and relevant regional...
Tags:
- Themes
Thetemplatesschema attribute is now deprecated for theapps.liquidsectionRead full post –>As of March 15, the
templatesschema attribute is no longer supported in theapps.liquidsection.- The
templatesschema attribute cannot be specified in theapps.liquidsection. - The...
Tags:
- API
- 2023-04
Webhooks for B2B Customers PrimitivesRead full post –>The Admin API
2023-04release introduces webhooks for B2B Customers, notifying on create, update, and delete actions for companies, locations, and contacts.Tags:
- API
- 2023-04
SVGs returned as MediaImage in Admin APIRead full post –>As of 2023-04, SVGs are treated as MediaImages by the Admin API.
This makes it easier to use SVGs in your online storefront.
Tags:
- API
- 2023-04
Consistent presence of null values on the order objectRead full post –>As of 2023-04, we're no longer filtering out
nullvalues on certain fields of theOrderobject. Previously, some keys withnullvalues would not be present on the REST API and webhook...Tags:
- Action Required
- Shopify App Store
Google Analytics 4 in the Google channel appRead full post –>Google Analytics 4 is now on Shopify's Google channel app, offering enhanced real-time, multi-channel measurement and privacy controls. Upgrade from Universal Analytics by July 1, 2023.
Tags:
- API
- 2023-04
Addedwallet_preferencesto theCartobjectRead full post –>As part of the GraphQL Storefront API 2023-04 API release, we are adding
to theCartobject. The wallet preferences from the cart will allow to pass through a buyer's wallet...Tags:
- API
JavaScript support for Shopify Functions developer previewRead full post –>The JavaScript support developer preview enables you to write functions in JavaScript or TypeScript, compile them to WebAssembly with Shopify CLI, deploy them to Shopify, and execute them on...
Tags:
- API
- 2023-04
Idempotent creation of AppUsageRecordRead full post –>In Admin GraphQL API 2023-04,
supportsto prevent duplicate charges, ensuring consistent responses for identical keys. UUIDs are recommended.Tags:
- API
- 2023-04
Translate Metaobjects with Translatable CapabilityRead full post –>New translatable capability allows metaobjects to be translated via the Translations API and Translate and Adapt app, enhancing localization options for developers.
Tags:
- Themes
New rich text setting functionality in online store editorRead full post –>We've added headings as well as ordered lists to the rich text setting within online store editor. This means that themes can now take advantage of this new semantic styling within the editor to...
Tags:
- API
- 2023-04
Partial updates for bulk product variants mutationRead full post –>In Admin GraphQL API 2023-04,
allows partial updates with. Defaults tofalse, enabling updates valid variants despite invalid ones.Tags:
- Shopify App Store
Increasing search relevance with behavioral dataRead full post –>As of February 27, Shopify App Store’s search algorithm folds in more data on how merchants interact with results after they search.
In other words, apps that merchants find most relevant, given...
Tags:
- API
Shopify Functions now support app-owned metafields and reserved prefixesRead full post –>Use the
$app:prefix in Shopify Functions input queries to ensure app-specific metafield ownership and control access. Metafields are private to your app by default.Tags:
- Action Required
- Themes
Introducing newenabled_on/disabled_onapp blocks schema attributes (deprecatingtemplates)Read full post –>New
andattributes replacetemplatesto control app block usage in templates and section groups. Use only one attribute per block.Tags:
- Action Required
- API
Deprecating Price Rules GraphQL APIRead full post –>Deprecating Price Rule GraphQL; migrate to Discounts GraphQL by April 2024 for full feature access. Update affected queries/mutations to ensure compatibility with future enhancements.
Tags:
- Action Required
- API
- 2023-04
Upcoming changes to Asset API approval scopeRead full post –>Theme App Extensions replace Asset API for public apps in Admin API 2023-04+. Streamlines theme integration, enhances security. Asset API access for create/update/delete is removed.
Tags:
- API
CompanyAddress name field changesRead full post –>CompanyAddress now uses a single recipient field instead of firstName/lastName. Existing templates auto-fill lastName with recipient; firstName is null. Transition to recipient field ongoing.
Tags:
- API
Certificate Update On Myshopify.Com DomainsRead full post –>Shopify will add Let's Encrypt and Google Trust Services certificates for myshopify.com subdomains on Feb 13, 2023. mTLS connections remain unaffected.
Tags:
- Action Required
- Tools
Checkout.liquid will no longer work for in-checkout pages starting August 13, 2024Read full post –>Shopify Plus merchants can now use checkout extensibility for in-checkout page customization, replacing checkout.liquid by August 13, 2024. Post-checkout customization remains unchanged.
Tags:
- Action Required
- API
Support for Shopify Scripts will end on August 13, 2024Read full post –>Shopify Scripts end of life extended to Aug 28, 2025. Migrate to Shopify Functions for customizations. Functions work with Scripts; more APIs coming to support migration.
Tags:
- API
JavaScript support in Shopify Functions local developer previewRead full post –>JavaScript support for Shopify Functions is now available in a local developer preview. This means you can try Shopify Functions with JavaScript locally, on your own development machine, but you...
Tags:
- API
New APIs and components for Checkout UI extensionsRead full post –>New APIs allow checkout UI extensions to access the storefront API, manage discounts/gift cards, and verify rendering. New UI components enhance interactivity and styling options.
Tags:
- API
Checkout UI extensions are now available on the order status page in developer previewRead full post –>Checkout UI extensions on the order status page are now available in the Checkout Extensibility developer preview. Add app-powered extensions or content to post-checkout pages such as surveys,...
Tags:
- API
Cart Transform API (Product Bundles) — Developer PreviewRead full post –>The Cart Transform API in developer preview lets you create and manage product bundles in checkout, simplifying backend tasks like tax calculation and inventory management.