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:
- Action Required
- Admin GraphQL API
- 2024-07
Product Feed variant images no longer fall back to product imageRead full post –>As of API version 2024-07, the variant image field in the
andwebhooks will no longer fall back to the product's first image when an image...Tags:
- Action Required
- Shopify App Store
Update on deprecation of unpublished appsRead full post –>Shopify requires all apps to pass App Store review for security and quality. Convert or sunset unpublished apps by the deadline to avoid API access revocation and uninstallation.
Tags:
- Platform
New timeout parameters for the Order Status PageRead full post –>Implemented level 2 data protection, new timeout parameters, and login requirements for Order Status Page. Include order numbers in SMS for enhanced security.
Tags:
- Admin GraphQL API
- 2024-04
Read full post –>Validation mutation endpoints now include optional title attributeTags:
- Admin GraphQL API
- 2024-04
New Location fields on GraphQL Admin APIRead full post –>As of version 2024-04 in the GraphQL Admin API, new fields
,, andhave been added to theLocationobject.Learn more about
Locationfields on...Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
Level 2 protected customer data requirements are now needed to access theorder.statusPageUrlfieldRead full post –>Apps must meet Level 2 Protected Customer Data Requirements to access
on all Admin APIs. This may be a breaking change to enhance customer data protection.Tags:
- Tools
ui-save-barcomponent added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the
ui-save-barcomponent and theReact component to declaratively control the contextual save bar, including settingloadingand...Tags:
- Tools
Modalsrcattribute added to the latest version of App BridgeRead full post –>With the latest version of App Bridge, you can use the
srcattribute with theui-modalcomponent and theModalReact component to display content from the provided URL. Learn more about it in...Tags:
- Admin GraphQL API
- 2024-04
Query retail cash tracking sessions with the GraphQL Admin APIRead full post –>Version 2024-04 adds GraphQL Admin API support for querying Shopify POS cash tracking sessions, providing data on transactions, staff actions, and discrepancies for POS Pro users.
Tags:
- Storefront GraphQL API
- 2024-04
Swatches and images for product filtersRead full post –>Version 2024-04 of the Storefront API introduces
,, andFilter.presentationfor enhanced visual filters. Requires Shopify's Search & Discovery app.Tags:
- API
POS UI Extensions 1.7 Update: Support for multiple cart discountsRead full post –>POS UI Extensions v1.7.0 adds
discountsto Cart,,APIs, andto List. Compatible with POS app v9.4.0.Tags:
- Admin GraphQL API
- 2024-04
FieldisGiftCardon all line item typesRead full post –>As of Admin GraphQL API version 2024-04, the
field that was present onandis now also present on:...
Tags:
- Shopify App Store
New Shopify App Store apps require the latest App BridgeRead full post –>As of March 13th, 2024, net new Shopify App Store apps must use the latest Shopify App Bridge by adding the
app-bridge.jsscript...Tags:
- Admin GraphQL API
- 2024-04
Customer Redaction support on Subscriptions APIsRead full post –>In Admin GraphQL API v2024-04, subscriptionContract mutations return CUSTOMER_REDACTED error for redacted customers, impacting subscription contract creation.
Tags:
- Liquid
New filter value swatch drop available, replacing the deprecated filter value's display dropRead full post –>Use the new Liquid swatch drop to create visual filters in themes. The filter value display drop is deprecated but remains functional for backward compatibility.
Tags:
- Storefront GraphQL API
- 2024-04
Delivery Groups now contain a group typeRead full post –>As of Storefront API's 2024-04 release, you can use
to determine whether a delivery group represents a single delivery () or is a recurring...Tags:
- API
More data available in the checkout_completed customer eventRead full post –>You can now collect the id of a customer within the order object of the checkout_completed customer event. This gives you more customer insights to improve marketing campaign targeting and...
Tags:
- Tools
Clarifications in the Webhooks Reference docsRead full post –>- Clarified webhooks-related terminology in the Webhooks Overview page to make it easier to get started
- Updated accuracy of...
Tags:
- Platform
Hydrogen March 2024 releaseRead full post –>Hydrogen v2024.1.3 adds experimental Vite support, a new
command, GitHub PR comments for Oxygen, and upgrades to Remix v2.8, enhancing performance and stability.Tags:
- Shopify App Store
App submissions now require a screencast demoRead full post –>Developers must submit a video demo for app submissions, drafts, and relisting. This aids review teams in understanding app functionality, expediting the review process.
Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Return Sales and Exchange APIsRead full post –>Returns now create Sales entries. New enums: ReturnAgreement, RETURN, FEE (RestockingFee, ReturnShippingFee). Admin API must accept new enums. New "returns/update" webhook added. INVALID_STATE error for canceled orders.
Tags:
- Action Required
- Admin GraphQL API
- 2024-04
Inventory Item new fields and ProductVariant deprecationsRead full post –>Admin GraphQL API 2024-04 adds
for weight and deprecates severalfields, streamlining inventory and product data management.Tags:
- Shopify App Store
Introducing category page ads on the Shopify App StoreRead full post –>Developers can now generate even more demand for their apps by showcasing them on the category and subcategory pages of the Shopify App Store.
Learn more about category page ads on...
Tags:
- Admin GraphQL API
- 2024-04
Filter product media by media_typeRead full post –>As of 2024-04, filter
Product.mediabylike. Migrate fromProduct.imagesto access all media types, enhancing app functionality and flexibility.Tags:
- Admin GraphQL API
- Admin REST API
- 2024-04
Add and remove shipping lines with new mutations on the order editing APIRead full post –>GraphQL Admin API
2024-04lets you add, remove, or update shipping lines in orders. Useto check removals. REST and webhooks now includefor tracking changes.Tags:
- Admin GraphQL API
- 2024-04
OrderPaymentStatus Now Exposes Related Order TransactionsRead full post –>As of 2024-04, you can now query the OrderPaymentStatus object to obtain information about its corresponding...
Tags:
- Admin GraphQL API
- 2024-04
New amount field on the OrderCreateMandatePayment MutationRead full post –>As of 2024-04, you can specify custom amounts to be charged from a vaulted card through the...
Tags:
- Admin GraphQL API
- 2024-04
New transactionVoid MutationRead full post –>As of version 2024-04 of the Admin GraphQL API, you can now void a transaction through the transactionVoid mutation. ...
Tags:
- Storefront GraphQL API
Defer Directive for Storefront API is now available in developer previewRead full post –>The @defer directive is in developer preview, enabling single GraphQL requests with streamed responses. Test it to help decide its inclusion in the Storefront API. Feedback is encouraged.
Tags:
- Platform
App Bridge React v4 releasedRead full post –>React developers can start using the App Bridge React v4 via NPM. This optional NPM package works with the [required App Bridge...
Tags:
- Admin GraphQL API
- 2024-04
lineItem.discountedTotalSetcan optionally include code based discountsRead full post –>The 2024-04 GraphQL Admin API adds
to, allowing inclusion of code-based discounts. Default isfalse, no client changes needed.Tags:
- Action Required
- API
- 2024-01
Return mutation will update sales (previously unchanged until time of Refund)Read full post –>As of Feb 20, 2024,
andmutations create return sales. Update todefinitions and usefor accurate sales ledger entries.Tags:
- API
POS UI Extensions 1.6 Update: Banner on CameraScanner and paginated variant fetchingRead full post –>POS UI Extensions 1.6.0 adds
to CameraScanner for banner display andto ProductSearch API for paginated variant fetching.Tags:
- Admin GraphQL API
- 2024-01
Product duplication now duplicates variant metafieldsRead full post –>Product duplication now includes variant metafields. Previously, variant metafields were ignored when products were duplicated. Products can be duplicated via...
Tags:
- Admin GraphQL API
- Admin REST API
- 2024-04
Deprecation of Order Risk APIs and Introduction of Risk Assessments APIRead full post –>Order risk REST and GraphQL APIs deprecated April 2024. Use new Risk Assessments API with orderRiskAssessmentCreate mutation and ORDERS_RISK_ASSESSMENT_CHANGED webhook.
Tags:
- Admin GraphQL API
- 2024-04
NewadditionalInformationobject argument onfulfillmentOrderqueryRead full post –>As of version 2024-04 of the Admin GraphQL API, you can read the
object value on theobject using the [...Tags:
- API
Store Credit Primitive and API now available in developer previewRead full post –>Shopify's new Store Credit API lets developers issue, track, and report store credits, differentiating them from gift cards, enhancing checkout and support workflows. Available in developer preview.
Tags:
- Platform
New OAuth2 Token Exchange API & Shopify managed install authorization flows availableRead full post –>New OAuth2 Token Exchange and Shopify managed install reduce redirects and flickers, speeding up app loads. Configure access scopes via CLI for seamless installation and token retrieval.
Tags:
- API
Cart and Checkout Validation Function APIRead full post –>You can now use Admin UI extensions to provide a user interface for merchants to configure your Cart and Checkout Validation Functions.
Additionally, merchants on any plan can now use validation...
Tags:
- API
- 2024-04
Checkout branding supports container stylesRead full post –>The Checkout Branding API now allows styling for main and order summary sections, enhancing control over design elements. Header and footer customization will follow in a future update.
Tags:
- API
- 2024-01
Checkout supports header and footer customizationsRead full post –>As of 2024-01-31, customize checkout headers/footers via GraphQL API. Hide elements, control layout, and use UI extensions for content. New targets for Checkout and Thank you pages.
Tags:
- API
New Discounts Allocator Function API in Developer PreviewRead full post –>You can now use the Discounts Allocator Function API in Developer Preview to implement custom logic for distributing discounts across multiple products or orders.
This new API allows you to...
Tags:
- Themes
Theme Check 2.0: Unified theme developer tools everywhereRead full post –>Theme Check 2.0 unifies Shopify theme tools, adding LSP features like hover docs, code completion for settings, translations, HTML, Liquid, and enhanced auto-closing in all editors.
Tags:
- API
Gain more customer behavior analytics with DOM eventsRead full post –>You can now subscribe to select DOM events with the Web Pixels API, including input_changed, input_blurred, input_focused,...
Tags:
- Tools
Hydrogen updates: Tool that make your path to production painlessRead full post –>The latest release enhances production with new tools: subrequest profiler, error console, CLI deploys, E2E testing, shareable previews, runtime mirroring, bundle insights, and CLI upgrades.
Tags:
- API
Customer Privacy API now available on Hydrogen & OxygenRead full post –>You can now integrate the Customer Privacy API and the Shopify Privacy & Compliance app into...
Tags:
- Shopify App Store
New structured app category detailsRead full post –>Shopify App Store now supports structured app category details, enhancing app evaluation for merchants. Categories include reviews, dropshipping, bundles, subscriptions, and more.
Tags:
- Shopify App Store
New install modal and data access section for apps with defines permissionsRead full post –>When you define the permissions your app requests, they will now show up in a new "Data Access" section on your app details...
Tags:
- Tools
[General Availability] Checkout Sheet Kit for Android, React Native, Swift v1.0.0Read full post –>Shopify's Checkout Sheet Kit v1.0.0 is now available for Android, React Native, and Swift, offering customizable, high-conversion checkouts in mobile apps. Open-source and ready to use.
Tags:
- API
New GraphQL APIs that support 2000 product variants now in developer previewRead full post –>Now in developer preview, we’ve introduced new GraphQL product APIs that support 2000 variants, allowing for support of more complex catalogs.
[Learn more...