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
TA and AC country codes will be added to GraphQL API version 2019-04Read full post –>GraphQL API v2019-04 adds TA and AC as distinct country codes, affecting shipping zones. Update CountryCode enums in Storefront and Admin APIs by March 22, 2021.
Tags:
- Shopify App Store
Attribution metrics for app store adsRead full post –>New Shopify App Store ad metrics, including CAC and ROAS, launch next week, enhancing ad spend analysis and ROI. Metrics apply to impressions from May 5, 2020, onwards.
Tags:
- API
- 2021-04
SUBSCRIPTION_POLICY value now available in the ShopPolicyType enumRead full post –>As of 2021-04, you can use the SUBSCRIPTION_POLICY value in the existing ShopPolicyType enum. This lets you...
Tags:
- API
- 2021-04
Delivery method property in the REST FullfillmentOrder resourceRead full post –>API version 2021-04 adds
toin REST Admin, detailing transfer types likelocal,none,,retail, orshipping.Tags:
- API
Vimeo embedded videos and ExternalVideo type changesRead full post –>Shopify now supports Vimeo videos in products via
. Newhostfield identifies video source, and twovalues improve Vimeo error handling.Tags:
- Themes
Show automatic international tax-inclusive prices using liquidRead full post –>With the launch of automatic international tax-inclusive pricing, whether or not prices have taxes included can vary based on the customer's country.
This change introduces a new liquid method...
Tags:
- API
Subscription-only product availability for online storesRead full post –>Subscription products without selling plans are now unavailable in the Online Store. The
property accurately reflects subscription requirements.Tags:
- API
International pricing support now added to the Product APIRead full post –>Regional price adjustments now appear in the presentment_prices property of Shopify's Product API. Eurozone prices remain unified across all Euro-using regions.
Tags:
- Action Required
- Tools
All embedded apps submitted for app review are required to adopt session tokensRead full post –>Session token-based authentication is now required for all embedded apps submitted for app reviews. This update helps mitigate the risk of embedded apps failing due to third-party cookie browser...
Tags:
- API
Kit Skills deprecated on April 1, 2021Read full post –>Kit, a Shopify app that automates some marketing tasks, and the Kit Skills API will be deprecated on April 1, 2021. The API will be removed on August 31, 2021, and won't work after that date.
To...
Tags:
- API
New Node library for apps to interact with the Admin APIRead full post –>Released Shopify Admin API library for Node, simplifying API interactions and speeding app development. Updated koa-shopify-auth, Node + React tutorial, and Shopify App CLI to use it.
Tags:
- API
- 2021-01
Discount code lookup API redirect now includes the API versionRead full post –>The DiscountCode lookup API now returns URLs with the requested API version, enhancing version control and reducing compatibility issues for developers.
Tags:
- API
Subscription APIs now support Shopify ScriptsRead full post –>Shopify Subscription APIs now support Shopify Scripts, enhancing subscription management. Check Shopify resources for usage details and future updates.
Tags:
- Themes
- 2021-01
The external_video Liquid object now supports YouTube and Vimeo videosRead full post –>Shopify now supports Vimeo videos in products via
. Use the unstable API to access Vimeo. Video host detection coming in 2021-04.Tags:
- Tools
New webhook metrics report for appsRead full post –>New webhook metrics report in Partner Dashboard tracks failed deliveries, response times, and removed subscriptions, aiding in troubleshooting and enhancing app reliability.
Tags:
- Themes
Detect the theme editor using Liquid and JavaScriptRead full post –>Detect theme editor using
in Liquid orin JavaScript. Update code to avoid unsupported methods for compatibility with the new theme editor.Tags:
- API
Pricing validations removed from all API versionsRead full post –>Reverted
validation; it no longer must exceedprice. Ignore related API Health notifications. No action needed if your app was updated for this change.Tags:
- Platform
Preview and upgrade your checkoutRead full post –>Upgrade Shopify Checkout by Feb 26, 2021, to access new features like subscriptions and local pickup while preserving checkout.liquid customizations. Automatic upgrades may break customizations.
Tags:
- API
Selling plans are deleted 48 hours after a merchant uninstalls their subscriptions appRead full post –>If a merchant uninstalls a subscriptions app, then 48 hours later selling plans and associated records (selling plan groups, policies, and their associations to products and variants) are deleted. ...
Tags:
- Tools
More granular permissions for the Partner DashboardRead full post –>Two new permissions, "View referrals" and "Manage affiliate campaigns," offer more control in the Partner Dashboard. Existing "Manage shops" users gain these permissions automatically.
Tags:
- API
Subscriptions API scopes are now available by requestRead full post –>Developers can now access Subscription APIs and App Extension to create flexible apps for new selling methods, compatible with all Shopify features like discounts and payments.
Tags:
- API
Quantity remaining no longer returned from Checkout API error messageRead full post –>Checkout API no longer shows inventory levels for privacy.
remaining: 1is a placeholder for legacy support, to be removed later. Check updated error responses in the documentation.Tags:
- API
The Partner API is now available for accessing App Events, Earnings, and Experts Jobs DataRead full post –>API access to App event, Earning, and Experts Marketplace Job data is now available to all Shopify Partners through the new Partner GraphQL API. This API allows programmatic access to data that was...
Tags:
- Platform
Checkout upgrade coming soonRead full post –>Shopify Plus users with checkout.liquid must upgrade between Jan 25-Feb 26, 2021, to access new features and keep customizations intact.
Tags:
- API
- 2021-01
Storefront API Product, Blog, and Page nodes now have SEO fieldsRead full post –>As of Storefront API version 2021-01, you can obtain the SEO details for...
Tags:
- Platform
Updates to our API License and Terms and Partner Program AgreementRead full post –>Updated API License and Partner Program Agreement effective Jan 1, 2021. Developers should review to ensure compliance and understand app development and distribution on Shopify.
Tags:
- API
- 2021-01
Auto-activation of charges and subscriptionsRead full post –>Starting in the 2021-01 release, app charges will auto-transition from pending to active upon merchant approval, removing the need for manual activation and simplifying billing.
Tags:
- API
- 2021-01
Product media in GraphQL Storefront API now ordered by positionRead full post –>As of the 2021-01 API version, product media information in the GraphQL Storefront API is returned in...
Tags:
- API
- 2021-01
Read full post –>Translated countries and provinces names available in Shipping ProfilesTags:
- Action Required
- API
Users endpoint now supports cursor-based paginationRead full post –>The Users endpoint now supports cursor-based pagination to prevent timeouts in shops with many users, improving response times and data management.
Tags:
- API
Pricing validations moved from 2020-04 to 2020-07Read full post –>Breaking change:
must be greater thanprice. Migration extended to2020-07. Check API Health, deprecation headers, and release notes for updates.Tags:
- Action Required
- Shopify App Store
App store ads team permissionsRead full post –>Shopify now allows customizable team permissions for App Store ads. Owners can set permissions for viewing/managing ads and financials in the Partner Dashboard's Team section.
Tags:
- API
- 2021-01
Localization extensions mutation updateRead full post –>GraphQL Admin API v2021-01 now supports updating checkout localization data via order mutations, aiding compliance with country-specific regulations like Brazilian CPF numbers.
Tags:
- API
- 2021-01
Updates to Image type on Storefront GraphQL APIRead full post –>The 2021-01 update allows easy access to original image dimensions, enhancing client-side rendering and preventing reflow in lazy-loaded images for better performance.
Tags:
- API
- 2021-01
New proxy feature for Script Tag APIRead full post –>As of the 2021-01 API version, you can now proxy script tags added to Storefront's via the ScriptTags API through Shopify infrastructure, allowing Shopify's globally distributed CDN to cache and...
Tags:
- API
Private apps can now check their deprecated callsRead full post –>Private apps can now check their deprecated calls through the Deprecated endpoint using the REST API.
Details can be found in the [REST API reference...
Tags:
- API
- 2021-01
Subscriptions API updateRead full post –>Subscription API updates: new fields for pricing, dates, and expiration; partial input for draft updates; new webhook; and removal of a delivery policy. Enhances flexibility and efficiency.
Tags:
- API
- 2021-01
Transaction fees available on the OrderTransaction resourceRead full post –>As of 2021-01, query transaction fees on OrderTransaction. TransactionFee details processing and foreign exchange fees, aiding in detailed financial analysis for developers.
Tags:
- API
- 2021-04
Duties are now available on the Storefront APIRead full post –>Storefront API 2021-04 adds duties to Checkout and Order resources. Key fields updated: lineItemsSubtotalPrice, paymentDueV2, subtotalPriceV2, and totalPriceV2. Delayed release to April 2021.
Tags:
- Action Required
- Themes
Deprecating Sass in themesRead full post –>Shopify themes will deprecate
.scssfiles, transitioning to.css. Developers should compile.scssto.csslocally. Future themes may not support.scss.Tags:
- API
Dynamic Timeout for CarrierService API Rate RequestsRead full post –>CarrierService API read timeouts now adjust dynamically based on requests per minute: 10s (<1500 RPM), 5s (1500-3000 RPM), 3s (>3000 RPM), optimizing checkout performance.
Tags:
- API
- 2021-01
Extended Authorization available in the APIRead full post –>As of 2021-01, apps can access Shopify Payments extended authorization fields by querying the [GraphQL...
Tags:
- Shopify App Store
New subscription and post-purchase up-sell app collections available nowRead full post –>New Shopify apps for subscriptions and upsells now integrate with Checkout using new APIs. Old apps are unavailable for download. Existing users unaffected; new users must choose integrated apps.
Tags:
- Themes
Show pickup availability on product pages for themesRead full post –>Debut theme update adds pickup availability, allowing merchants to display local pickup options and estimated times on product pages, enhancing customer experience.
Tags:
- Platform
New collaborator account access security featureRead full post –>New security feature: Merchants can set a 4-digit code for collaborator access requests. Obtain the code from merchants to access their store if this feature is enabled.
Tags:
- Shopify App Store
App store ads - RelevanceRead full post –>We've released a new reporting column for App store ads - relevance. The relevance column provides advertisers with a more explicit signal for how relevant their app is for any given search...
Tags:
- Platform
New ‘Charge_ID’ field in the Partner Payout CSVRead full post –>New 'Charge_ID' field in Partner Payout CSV helps app developers reconcile charges with payouts. Available only in new CSV downloads from October 14th.
Tags:
- API
New Subscription APIs and Product Subscription Extension available in early accessRead full post –>New APIs and tools enable subscription integration on Shopify storefronts, supporting flexible selling methods and compatibility with platform features like discounts and payments.
Tags:
- Shopify App Store
App store ads - Bid suggestions updateRead full post –>Updated bid suggestions now provide more accurate competitive insights for keywords, enhancing ad visibility for exact matches and competitiveness for broad matches.
Tags:
- API
New shippingPolicy field on Shop objectRead full post –>As of the 2020-10 API version, you can query a shop's shipping policy using the
field on the Shop object.To learn more about the
field, refer to our [developer...