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:
- Platform
Change to merchant billingRead full post –>We’re adding more flexibility to merchant billing, making it easier for your users to keep running their businesses during COVID-19 and avoid store shutdowns. The change means that you might see...
Tags:
- Platform
All-new Shopify POS is now availableRead full post –>Shopify POS 6.0 introduces a new smart grid interface, global search, and analytics. Existing apps remain compatible, adapting automatically to the redesign, enhancing omnichannel capabilities.
Tags:
- Shopify App Store
Improved reporting for app store adsRead full post –>Improved ad reporting with new columns: "Average position" for ad display rank and "Visibility" for first-page impression percentage, applicable from March 11, 2020.
Tags:
- Platform
Pause plan introduced - app access and billings restricted during pauseRead full post –>Shopify's new Pause plan lets merchants pause stores for 3 months, freezing app billing but retaining installations. No developer action needed; updates appear in webhooks and dashboards.
Tags:
- API
Amount no longer required on DraftOrderAppliedDiscountInputRead full post –>The
amountfield is no longer a required field on. If omitted, then theamountis automatically calculated based on thevalueand. This avoids...Tags:
- Themes
Updates to the Online Store Design Experience partner betaRead full post –>New features for the Online Store Design Experience beta: Sections on Cart, Password, 404 pages; Section Rendering API for AJAX updates;
wrapperproperty for HTML tags;linksetting type.Tags:
- Shopify App Store
Update to how app ratings are calculatedRead full post –>Star ratings now use a weighted average favoring recent reviews, reflecting current app capabilities. Search rankings remain unaffected. Engage users for more reviews and respond to feedback.
Tags:
- API
Length of the Shopify access token is increasingRead full post –>Shopify access tokens will increase from 32 to 38 characters with a static prefix. Update apps and databases to handle longer tokens by April 1st to avoid issues.
Tags:
- API
API version 2020-04 is now stable and ready for general usageRead full post –>The 2020-04 release enhances Storefront API with order parameters, international duties info, and expanded product media fields, improving data representation and integration.
Tags:
- API
Order duties released in developer previewRead full post –>New developer preview lets merchants charge Shopify-calculated duties at checkout, view/refund via APIs. Enable on dev store with 'Duties and Taxes' preview for testing.
Tags:
- Platform
Changes to order and payment testing on newly created development storesRead full post –>Partners can now test orders in dev stores using Shopify's test payment or a provider in test mode. Real transactions require a paid plan. Existing stores remain unchanged for now.
Tags:
- API
Changes to 2019-04 version timelineRead full post –>API version removal postponed to July 1, 2020. Update apps for 2019-07 and 2019-10 versions. Switch to cursor-based pagination by July 1. Check deprecated calls in API Health report.
Tags:
- Action Required
- API
New password errors for customer mutationsRead full post –>The
,,, andmutations now return more specific error codes when users enter a password input that is invalid. These...Tags:
- API
New Storefront API fields on the Order and OrderLineItem objectsRead full post –>New Storefront API fields for Order and OrderLineItem provide enhanced order state visibility post-edit, including fulfillment status, financial status, and pricing details.
Tags:
- Platform
Partner Program Agreement updates - Shopify as a billing agent, custom and public appsRead full post –>The Partner Program Agreement now defines public/custom apps and clarifies Shopify as a billing agent. Billing/tax updates effective June 1, 2020, with 90 days notice provided to partners.
Tags:
- Tools
Get insights into API updates that affect your apps with our new API Health reportRead full post –>The new API Health report on the Partner dashboard shows the deprecated API calls your apps are making, along with documentation and timelines that help keep your apps up to date with Shopify’s API...
Tags:
- API
New customerActivateByUrl mutationRead full post –>Use the
mutation to activate customer accounts without parsing the activation URL for the customer ID and token. Just send the full URL and a new password to activate the...Tags:
- API
New customerAccessTokenCreateWithMultipass mutationRead full post –>Use
to log in customers using a multipass token. Automatically creates customer records if they don't exist.Tags:
- Tools
Store-specific status now available on Shopify’s updated status pageRead full post –>Shopify status updates are now store-specific, deprecating SMS/RSS alerts. Partners should check store-specific pages for status info. Public major outage updates remain on shopifystatus.com.
Tags:
- Shopify App Store
Search ads on the Shopify App Store are rolling-out to all qualified partnersRead full post –>Qualified partners can now create search ads in the Shopify App Store, appearing above organic results, targeting specific search terms to enhance app visibility to merchants.
Tags:
- Tools
Shopify POS supports iOS 11.2 or higherRead full post –>From Feb 10, 2020, Shopify POS requires iOS 11.2+ for updates. Developers should target iOS 11.2+ for optimal app performance on POS Classic and new Shopify POS.
Tags:
- Themes
New article.updated_at Liquid property and updated behavior for cartRead full post –>New
property aids SEO.cart.attributesnow hides keys with__prefix.supports adding multiple items in one request, simplifying cart operations.Tags:
- API
App secret key length has increasedRead full post –>Shopify app secret keys now have a 38-character length with a
prefix. Existing keys remain valid until regenerated. Update yourfor OAuth access tokens.Tags:
- Themes
Sections theme architecture released in developer previewRead full post –>Developer preview of new sections theme architecture allows customization of headers, footers, and content sections on product pages. Edit themes for compatibility with this new design experience.
Tags:
- Tools
New app snippets and app sections extensions released in developer previewRead full post –>New app extensions: App sections for editable content sections and App snippets for safe Liquid code injection, enhancing store customization in the online store editor beta.
Tags:
- Tools
New online store design experience beta available in developer previewRead full post –>Preview our new online store design: install the Debut theme, customize product pages with sections, and explore the editor. All page types will be supported soon.
Tags:
- Action Required
- Tools
shopify_app Ruby gem and koa-shopify-auth for Node.js updated to work with Chrome 80Read full post –>Update
gem andkoa-shopify-authfor Node.js to setSamesite=none; Securein cookies, preventing issues with Chrome 80's new requirements.Tags:
- API
Inventory Quantity available on Storefront GraphQL APIRead full post –>With the release of the 2020-04 version of the Storefront GraphQL API, you can now access your inventory quantity if needed to build your shopping experience.
This information is hidden by...
Tags:
- Tools
Debug your Liquid render performance using Shopify Theme Inspector for ChromeRead full post –>Shopify Theme Inspector for Chrome benchmarks Liquid performance, visualizes issues with flame graphs, and links directly to code for easy editing, enhancing theme optimization.
Tags:
- API
Collections added to the predictive search APIRead full post –>Searchable resources for our predictive search API now include collections.
Read more about the predictive search API...
Tags:
- API
API version 2020-01 is now stable and ready for general usageRead full post –>The 2020-01 release stabilizes product media, order editing, and fulfillment orders. Enhancements to smart collections and discount codes improve merchant store management.
Tags:
- API
New Collection REST Admin APIRead full post –>With the release of the 2020-01 version of the REST Admin API, a new Collection API is available with the following features:
- Get the products in a collection
- Get a collection by its ID
...
Tags:
- Action Required
- API
Collects API now returns only collects associated with custom collections.Read full post –>The 2020-01 REST Admin API update removes products from Smart Collections in Collects API. New APIs now fetch products in collections and collections by ID.
Tags:
- API
Additional image details added to predictive search APIRead full post –>Predictive Search now includes
details: alt, width, height, aspect ratio, and URL, enhancing image data access for developers.Tags:
- Action Required
- API
GraphQL input objects limited to 250 itemsRead full post –>As of API version 2020-01, Storefront and Admin GraphQL requests return errors if any input array is supplied with more than 250 objects. We’re bringing input limits in-line with connection limits...
Tags:
- API
New order/edited webhook and order editing API capabilitiesRead full post –>Order editing is now available for select Shopify merchants with new APIs in version 2020-01, including GraphQL mutations and an
webhook for tracking changes.Tags:
- Tools
Update to public apps and introducing custom appsRead full post –>We’re putting safeguards in place for future Shopify public apps and introducing a new type of custom app.
No existing apps will be affected by this release.
Read more on the [Shopify Web...
Tags:
- API
Unit pricing information now available through Storefront APIRead full post –>The Storefront API now includes unit price fields for select Shopify merchants, enhancing product variant data with presentmentUnitPrices, unitPrice, and unitPriceMeasurement.
Tags:
- Themes
New Liquid global object and propertyRead full post –>Liquid update: New
,routes, andproperties added.defaultfilter now supportsfor setting default values.Tags:
- Tools
Buy Button JS now defers checkout creation until a variant is added to cartRead full post –>The Buy Button cart model is now null until a variant is added, improving performance. Verify custom code using the cart model to ensure functionality remains intact.
Tags:
- Action Required
- Themes
Deprecating the include liquid tag and introducing the render tagRead full post –>The
includetag is deprecated; userenderfor better performance and maintainability. Update apps to pass variables explicitly inrenderby Feb 17, 2020.Tags:
- API
Improved GraphQL errorsRead full post –>GraphQL errors now include metadata under
extensions, featuring acodeproperty for easier error type matching, enhancing error handling per GraphQL spec.Tags:
- API
New searchable resources added to the predictive search APIRead full post –>Predictive search APIs now include pages, articles, and more product fields. Key parameter updates:
stoq,burytolast,typestotype. Out of stock items show last by default.Tags:
- API
Discounts API - New Buy X Get Y optionRead full post –>Buy X Get Y discounts now support a minimum purchase amount, offering flexibility in promotions via automatic discounts or discount codes using the Discounts GraphQL API.
Tags:
- API
API version 2019-10 is now availableRead full post –>Version 2019-10 enhances performance with cursor-based pagination, bulk data operations, private metafields, translations, delivery updates, and 3D Secure support in APIs.
Tags:
- API
Bulk operations added to the Admin GraphQL APIRead full post –>You can now retrieve large amounts of data from our Admin GraphQL API using bulk operations. Provide a standard GraphQL query to the [bulk...
Tags:
- API
Performance improvements for the Storefront API product collectionsRead full post –>Querying a product's collections is now faster because we've optimized how we build the connection between a product and its collections.
Since this is a new way of building out connections and...
Tags:
- API
The Checkout API and Storefront API have been updated to support the Revised Payment Service Directive (PSD2)Read full post –>Shopify now supports PSD2 compliance with 3D Secure for EEA transactions. Update your app to the 2019-10 API version for full payment authentication support.
Tags:
- Tools
Buy Button carts now support automatic discountsRead full post –>Buy Button JS now supports automatic discounts by default. Check cart appearance and customization options when upgrading to avoid unexpected behavior.
Tags:
- Shopify App Store
Selecting a primary language for your listingsRead full post –>Create app listings in any supported language, set any language as primary, and no longer require English. Ensure your app is translated in the chosen languages.