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:
- Customer Account API
- 2025-01
Add PickupAddress for subscription contracts in customer APIRead full post –>As of 2025-01, you can use the
field in bothandto query for a customer pickup address.Learn more about this...
Tags:
- Platform
- Admin GraphQL API
Increased limits for automatic function-based discountsRead full post –>The discount limit in our system increased from 5 to 25, enabling developers to manage more campaigns with precise timing and migrate from Shopify Scripts to Shopify Functions.
Tags:
- Shopify App Store
Search and browse apps using structured category details in the Shopify App StoreRead full post –>Merchants can now search and browse apps based on a specific category feature in the Shopify App Store. Keep your apps updated with the most relevant category features and follow our [best...
Tags:
- Themes
New dynamic source attributes available in the online store editorRead full post –>You can now use more dynamic source attributes in the online store editor. The following new attributes have been added:
- Product:
url,,description - Collection:...
Tags:
- Shopify App Store
Strongly-matched apps will be highlighted in Shopify app store search resultsRead full post –>Apps with strong brand term matches now appear at the top of search results. Restricted keywords for search ads are removed, allowing more bidding options and aligning with industry standards.
Tags:
- API
Edit customer account menu including adding full-page extensionsRead full post –>Developers can now edit customer account header menus, link all full-page extensions by default, and use the same menu across stores. Navigation tool moved to Admin > Content > Menus.
Tags:
- Admin GraphQL API
- Admin REST API
- 2025-01
manualPaymentGatewayfield added toorderTransactionobjectRead full post –>As of GraphQL Admin API version 2025-01, the
field will be added toobject. This field indicates if the transaction is processed by a manual payment...Tags:
- Built for Shopify
Built for Shopify category-specific criteria are now availableRead full post –>Category-specific criteria for Built for Shopify apps are now available, aiding developers in accurate app categorization. Mandatory for reviews starting January 2025.
Tags:
- Action Required
- API
- 2025-01
Conditionally disable gift cards in checkout using custom logic with the Payment Customization APIRead full post –>As of Nov 12, 2024, the Payment Customization API allows disabling gift card features, hiding fields, and removing applied cards. Available in unstable and stable 2025-01 API versions.
Tags:
- Tools
Marketing Activity Extensions can be migrated to CLIRead full post –>As of Shopify CLI 3.70, existing Marketing Activity Extensions can be migrated from the Partner Dashboard to CLI. Learn more about how to import and migrate your Marketing Activity Extensions to...
Tags:
- Action Required
- Themes
Changes to our Font LibraryRead full post –>Shopify has deprecated some fonts and added 32 new open-source typefaces. Theme developers must replace deprecated fonts by Jan 3, 2025, using recommended or available alternatives.
Tags:
- Built for Shopify
Built for Shopify Fulfillment services assessments category specific criteriaRead full post –>The Built for Shopify category-specific criteria assessments are now available for...
Tags:
- Action Required
- POS Extensions
POS Legacy Extensions Will Be Deprecated in February 2025Read full post –>On Feb 28, 2025, Shopify POS will deprecate POS Links, cart app, and product recommendation extensions. Rebuild using POS UI Extensions for enhanced capabilities.
Tags:
- Action Required
- Admin GraphQL API
- 2025-01
RemovemetafieldDeletein favor ofmetafieldsDeleteRead full post –>As of
2025-01theAdmin API method is being removed. Themethod should be used instead. The former relies on the Metafield GID, while the latter takes an...Tags:
- Admin GraphQL API
- 2024-10
Updates to Shopify’s Standard Product Taxonomy - October 2024Read full post –>Shopify's 2024-10 taxonomy update adds new categories and attributes for better product classification in areas like Apparel, Home, and Sporting Goods, enhancing accuracy and user feedback integration.
Tags:
- Admin GraphQL API
- Customer Account API
- Payments Apps API
- 2025-01
GraphQL Over HTTPRead full post –>GraphQL requests now support
format, affecting status codes. Use/graphqlendpoint,content type, and updatedAcceptheaders for2025-01API.Tags:
- Action Required
- Admin GraphQL API
- Customer Account API
- Payments Apps API
- 2025-01
Content typeapplication/graphqlis deprecatedRead full post –>The
request format is deprecated and will no longer be accepted as of 2025-01 schema versions. As of2025-01schemas, all requests must specify `Content-Type:...Tags:
- Action Required
- Admin GraphQL API
- 2025-01
RemovingmultiLocationfield fromShopFeaturesRead full post –>As of the 2025-01 release of the Admin GraphQL API, the deprecated
field on ShopFeatures will be...Tags:
- Tools
Merchants can now view your app extension collectionsRead full post –>As of Oct 31, 2024, merchants can now manage their apps using the new Apps tab, which includes app extension collections.
Note: If your app contains customer account UI extensions, these...
Tags:
- Themes
Metaobject and metaobject_list theme settings now availableRead full post –>Added
metaobjectandtheme settings for consuming specified metaobjects. Use standard metaobject definitions for theme store themes.Tags:
- Platform
- 2024-10
Hydrogen October 2024 releaseRead full post –>Hydrogen v2024.10.0 adds Storefront API 2024-10 support, cart warnings, product option updates, worker compatibility, and optimizations. Deprecated features removed for improved performance.
Tags:
- Action Required
- Themes
Change to metafield type handling in liquidRead full post –>Metafields without a
typenow default to "string" instead ofblank. Update your checks to ensure compatibility with this change.Tags:
- Action Required
- Themes
- Liquid
Updates to Theme Information Access in ShopifyRead full post –>Transition from BOOMR to
window.Shopify.themefor theme data by 31/01/2025. Useandfor reliable theme info. BOOMR support ends on this date.Tags:
- API
Web pixels now support checkout error eventsRead full post –>We’re rolling out new standard events to web pixels that enable you to better understand the issues that buyers encounter in checkout. Merchants can now capture specific alerts seen by buyers, such...
Tags:
- Action Required
- Platform
Breaking Changes to CAPTCHA protection on Storefront formsRead full post –>Starting 28th Oct 2024, hCaptcha is required for login, account creation, and password reset forms. reCAPTCHA is deprecated; update custom code to avoid 400 errors.
Tags:
- Action Required
- Admin GraphQL API
- 2025-01
Update tofulfillmentHold.heldByAppfield fromfulfillmentHold.heldByfieldRead full post –>In API version 2025-01,
is replaced byin. Update queries tofor full app details.Tags:
- API
- 2024-10
Limit for full-page extensions in customer accountsRead full post –>Full-page extensions can't coexist with others in the same extension, enhancing performance. Use editor extension collections for compatibility. Affects new or updated extensions only.
Tags:
- Built for Shopify
Built for Shopify update to grace period for programmatically assessed criteriaRead full post –>Grace period for criteria like store speed and app rating extended to 60 days. Fulfillment and Carrier services criteria will also have a 60-day grace period upon enforcement.
Tags:
- Storefront GraphQL API
- 2025-01
Storefront API Cart now supports removing Gift CardsRead full post –>As of version 2025-01 of the GraphQL Storefront API, Cart now supports removing Gift Cards by Id.
After a cart has been created and a Gift Card applied - perform the...
Tags:
- Action Required
- Shopify App Store
Shopify App Store apps require the latest App BridgeRead full post –>Starting October 15th, 2025, all Shopify App Store apps that appear in the Shopify admin must use the latest Shopify App Bridge by...
Tags:
- Admin GraphQL API
- Storefront GraphQL API
- 2024-10
APIStringConnectionincludesnodesfieldRead full post –>As of API version
2025-01, you can accessfield shorthand to retrieve an array of strings directly instead of viaedges. This connection type is now consistent with...Tags:
- Platform
Deep link to editor extension collectionsRead full post –>Deep link to editor extension collections in checkout/accounts editor on dev stores. Streamline merchant onboarding with app deep links when released to merchants.
Tags:
- API
Checkout UI extensions - Extensions in the reductions render before/after targets will now render in the header order summary on 1 page mobile checkoutsRead full post –>Checkout UI extensions for
purchase.checkout.reductions.render-beforeandrender-afternow render at the top of one-page mobile checkouts, enhancing visibility across all API versions.Tags:
- Admin GraphQL API
- 2024-10
Shopify Payments Payout Summary GraphQL surfaces advance fees and advance gross fieldsRead full post –>GraphQL Admin API 2024-10 adds
ADVANCE_FEESandADVANCE_GROSSfields to ShopifyPaymentsPayoutSummary, enhancing payout detail visibility for developers.Tags:
- Platform
Shopify Function resource limits now scale with cart sizeRead full post –>Certain Shopify Function resource limits now scale proportionally to the number of line items in the cart. Starting at 200 line items, your Shopify Function runs will be able to use more resources...
Tags:
- Shopify App Store
Install Attributions in Partners Merchant ExportRead full post –>The merchant export in Partners now provides an "Attribution" column that specifies installs that are attributable to Shopify App Store ad clicks. For more information on the Partners merchant...
Tags:
- Admin GraphQL API
- 2024-07
lineItemconnection is no longer deprecated onFulfillmentOrderLineItemresourceRead full post –>As of today, you can use the
onwithout planning for deprecation. This applies to all API versions.Learn more about
on...Tags:
- Admin GraphQL API
- 2025-01
Updated CalculateExchangeLineItemInput and CalculatedExchangeLineItem Variant nullabilityRead full post –>In Admin GraphQL API
2025-01,andare nullable, butstill requires validation.Tags:
- Admin GraphQL API
- 2025-01
AddaccountOpenerNametoshopifyPaymentsAccountRead full post –>As of GraphQL Admin API version 2025-01, the
field will be added toTags:
- Admin GraphQL API
- 2025-01
Bulk query operation userErrors now includes code fieldRead full post –>As of version 2025-01, the
field that is returned by the Admin APIwill include an optionalcodefield.Tags:
- Admin GraphQL API
- 2024-10
Shopify Payments Balance Transaction GraphQL type supports advance and advance funding typeRead full post –>GraphQL Admin API 2024-10 adds
ADVANCEandADVANCE_FUNDINGto ShopifyPaymentsTransactionType, enhancing transaction categorization for developers.Tags:
- Admin GraphQL API
- Admin REST API
- Storefront GraphQL API
- 2024-10
Exposing Business Entity fields on Admin APIRead full post –>GraphQL Admin API v2024-10 introduces Business Entity attributes for querying. Order REST API v2024-10 and webhooks now include Business Entity identifiers.
Tags:
- Admin GraphQL API
- 2024-10
Shopify Payments GraphQL Admin API supports querying a list of disputesRead full post –>GraphQL Admin API 2024-10 now supports querying all disputes for a shop as a GraphQL connection, enhancing data retrieval for developers.
Tags:
- Admin GraphQL API
- 2024-10
Addedvariant_strategyforproductOptionsCreateRead full post –>The 2024-10 Admin GraphQL API adds
to, offeringLEAVE_AS_ISorCREATEstrategies for better variant and inventory management.Tags:
- Admin GraphQL API
- 2024-10
AddingrequiresComponentsfield toProductVariantsBulkInputRead full post –>As of the 2024-10 version of the GraphQL Admin API, the
field available inhas been added to.This field allows variants to...
Tags:
- Admin GraphQL API
- 2024-10
NewCollectionsCountquery in the GraphQL Admin APIRead full post –>As of
2024-10version, we are addingquery to the Admin GraphQL API.Learn more about...
Tags:
- Admin GraphQL API
- Webhook
- 2024-10
Metafield Definition WebhooksRead full post –>As of GraphQL Admin API Version 2024-10, you can subscribe to MetafieldDefinition changes under the webhook topics
,, and...Tags:
- Action Required
- Tools
Starting April 2025, new public apps submitted to Shopify app store must use GraphQLRead full post –>Shopify's GraphQL is now the primary API, with REST marked as legacy. From April 1, 2025, all new apps must use GraphQL. Migration timelines for existing apps will be announced in 2025.
Tags:
- Shopify Theme Store
- 2024-10
Theme Store ranking updateRead full post –>As of October 1st, 2024 we have update the Theme Store algorithm. This new ranking system will refine how themes are discovered, prioritizing factors like recency, quality, and trust signals to...
Tags:
- Admin GraphQL API
- 2025-01
ShopifyPaymentsBankAccount GraphQL Admin API unused fields removedRead full post –>As of GraphQL Admin API version 2025-01, we're cleaning up the
endpoint and removing several unused fields.