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:
- Themes
New Full-Funnel Theme Install Parameters and Now Firing E-Commerce Events on the Theme Listing PageRead full post –>Added
andto theme install events for better merchant insights. Implemented Google e-commerce events for enhanced tracking and precise data analysis in Shopify Theme Store.Tags:
- Tools
JavaScript Shopify Functions are now ~40% fasterRead full post –>As of Shopify CLI 3.67 and Javy 3.1, Shopify Functions built in JavaScript can see improved performance by as much as 40% when combined with [@shopify/shopify_function...
Tags:
- Shopify App Store
New Full-Funnel App Install Parameters and Now Firing E-Commerce Events on the App Listing PageRead full post –>New parameters
andadded for app install events in Shopify, plus Google e-commerce events for better tracking and data analysis on app listing pages.Tags:
- Webhook
Product Feed webhooks now support per-market inventoryRead full post –>The
andfields will now reflect country-specific inventory availability, scoped to the specified market country of the Product Feed. The Fulfillable Inventory...Tags:
- Platform
Post-purchase offers limit is increasedRead full post –>Post-purchase upsell offers increased from 2 to 3, boosting order value potential. Review custom code for optimal buyer experience.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Improvements in the GiftCard GraphQL endpoints and introducing GiftCardTransaction typesRead full post –>GraphQL Admin API 2024-10:
endpoints open to all; newtypes. Renameto. Addand transaction fields.Tags:
- Action Required
- Admin GraphQL API
- 2024-10
The fulfillmentOrdersReleaseHolds Mutation Is DeprecatedRead full post –>As of the Admin API version 2024-10, the fulfillmentOrdersReleaseHolds mutation has been deprecated.
...
Tags:
- Admin GraphQL API
- 2024-10
Admin API includesurlRedirectsCountRead full post –>As of Admin GraphQL API version
2024-10, you can accessfield to retrieve the count of redirects.Learn more about
on...Tags:
- Admin GraphQL API
- 2024-10
New query attributes on products queryRead full post –>As of the 2024-10 version of the GraphQL Admin API, the
productsquery filter has been expanded to allow filtering on additional attributes:,and...Tags:
- Action Required
- Admin REST API
- 2024-10
Field deprecations on the abandoned checkout REST APIRead full post –>Several fields deprecated from Abandoned Checkout REST API; switch to new GraphQL API by 2024-10 for continued support.
Tags:
- Admin GraphQL API
- 2024-10
Fulfillment Holds Now Able To Be Released by IDRead full post –>GraphQL Admin API 2024-10 adds
idtoand optionaltomutation, allowing precise hold releases by ID.Tags:
- Admin GraphQL API
- 2024-10
Admin API includesstatusPageUrlfield onOrderRead full post –>As of Admin GraphQL API version
2024-10, you can accessfield to retrieve the URL where the customer can check the order's current status.Learn more about
Orderon...Tags:
- Admin GraphQL API
- Admin REST API
- Webhook
- 2024-07
Customer SMS Consent Collected From now returns Shopify when the buyer consents to SMS marketing in Shopify CheckoutRead full post –>From Sept 12, 2024,
returnsSHOPIFYfor SMS consent in Shopify Checkout, affecting 1st party and UI extensions; other flows remain unchanged.Tags:
- Platform
Hydrogen September 2024 releaseRead full post –>Hydrogen v2024.7.5 enhances sitemaps, search, cart gift cards, and security. Fixes redirects and mobile links. Adds privacy utilities. Optimizes cart totals.
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-10
Introducing PRODUCT_CATEGORY_ID in CollectionRuleColumn and Deprecating PRODUCT_TAXONOMY_NODE_ID for automated collection creationRead full post –>API v2024-10 introduces
PRODUCT_CATEGORY_IDinfor smart collections, replacing deprecatedPRODUCT_TAXONOMY_NODE_ID. Update implementations for enhanced functionality.Tags:
- Webhook
Updates to webhook retry mechanismRead full post –>Webhooks retry 8 times over 4 hours with exponential backoff. Original payloads are used; check timestamps for staleness. Address updates won't affect retries. Improves delivery reliability.
Tags:
- Tools
Static app navigation for admin apps is no longer supportedRead full post –>Static app navigation for admin apps is deprecated. Use App Bridge components for navigation. Delete existing menus via Partners dashboard by Dec 2024; auto-removal by Dec 2026.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Removing V2 suffix from fulfillmentCreateV2 and fulfillmentTrackingInfoUpdateV2Read full post –>As of
2024-10, we're deprecatingand. Instead, please useand.Note that the...
Tags:
- Action Required
- Admin REST API
- 2024-10
The REST location resource requireslocationsscopeRead full post –>The 2024-10 Admin REST API requires the
scope to access the location resource. Without it, a 403 Forbidden error occurs. Update your app permissions accordingly.Tags:
- Shopify Theme Store
Fresh theme rows for Theme Store homepageRead full post –>To help merchants discover the freshest and most well-integrated themes for their store, we've shipped an update to the Theme Store homepage to highlight Top and New themes (published in the last...
Tags:
- Liquid
- Storefront GraphQL API
- 2024-10
Storefront Product Taxonomy Category APIRead full post –>GraphQL Storefront API 2024-10 now supports retrieving product taxonomy categories, enhancing storefront customization. Available via both GraphQL and Liquid APIs for improved buyer experience.
Tags:
- Admin GraphQL API
- 2024-10
Allow item activation at legacy locationRead full post –>GraphQL Admin API 2024-10 adds
tomutation, enabling inventory activation at non-SKU-sharing locations. Ensure parameter is true for such activations.Tags:
- Action Required
- Admin GraphQL API
- 2024-10
ReverseFulfillmentOrderLineItem.fulfillmentLineItem field is nullable as of 2024-10Read full post –>As of 2024-10,
is nullable. Older API versions will error ifis missing.Tags:
- Admin GraphQL API
- 2024-10
Admin API removeslineItemsMutablefield onOrderRead full post –>As of Admin GraphQL API version
2024-10, useinstead offield to get a list of the order's line items.Learn more about
Orderon...Tags:
- Admin GraphQL API
- 2024-01
Customer, Order, Company, and Model3d GraphQL types available in MetafieldReference union for 2024-01 and onwardRead full post –>We are retroactively adding Customer, Order, Company, and Model3d graphql types to the MetafieldReference union for...
Tags:
- Action Required
- Customer Account API
- 2024-01
Protected customer data access required to use the Customer Account APIRead full post –>Apps must meet Level 1 Protected Customer Data Requirements to access the Customer Account GraphQL API, affecting public apps but not Hydrogen, Headless, or Custom Apps.
Tags:
- Admin GraphQL API
- 2024-10
AddingproductVariantsCountGraphQL field.Read full post –>As of
2024-10version, we are addingfield to the Admin GraphQL API.Learn more about...
Tags:
- Built for Shopify
Built for Shopify Technical criteria checklist has been updatedRead full post –>Renamed criteria, updated app distribution layout, added category-specific section, merged safety and design standards, and removed outdated app listing requirements for clarity.
Tags:
- Shopify Theme Store
Updates to Feature Filters, Theme Listing & Partner PagesRead full post –>- Merchants can now filter themes by 3 new features: "Quick Order List", "Sign in with Shop" & "Swatch Filters". And we have removed 3 feature filters: "Product reviews", "Event Calendar" & "Store...
Tags:
- Admin GraphQL API
- 2024-10
Remove unused error codes from LocationDeactivateUserErrorCodeRead full post –>The 2024-10 GraphQL Admin API release removes
HAS_OPEN_TRANSFERS_ERRORandFAILED_TO_RELOCATE_OPEN_TRANSFERSfrom. Update code to remove checks.Tags:
- Admin GraphQL API
- 2024-10
ShopifyPaymentsAccount GraphQL Admin API unused fields removedRead full post –>As of GraphQL Admin API version 2024-10, we're cleaning up the
endpoint and removing several unused fields.Tags:
- Tools
Shopify Functions log streaming and replay is now generally availableRead full post –>As of Shopify CLI 3.66, log streaming and replay for Shopify Functions is generally available.
Log streaming for Shopify Functions enables faster development, testing, and debugging of functions...
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Breaking changes to media in GraphQL API's ProductSet mutation in version 2024-10Read full post –>GraphQL API v2024-10 introduces
for enhanced media handling in. Replacesandwithfilesandfilefields for better file management.Tags:
- Platform
Metafields and metaobjects reserved prefixes now supported in theme app extensionsRead full post –>When accessing metafield namespaces or metaobject types, you no longer need to hard code
. The$appreserved prefix is now available to use in your Liquid files.Learn more...
Tags:
- Action Required
- Themes
Developer Preview: Accelerated Checkout Buttons on storefront now support Shopify Functions, Bundles, and have improved performanceRead full post –>Dynamic and Accelerated Checkout buttons now support Shopify Functions and Product Bundles. Note: Accelerated Checkout uses shadow DOM, affecting styling and event tracking. Changes live Sept 15.
Tags:
- Storefront GraphQL API
Storefront API changes when Cart ID is missing the key paramRead full post –>Storefront API now requires the key param in cart queries/mutations. Missing key removes private details in queries and causes errors in mutations. Applies to all API versions.
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Deprecation Notice:ProductChangeStatusin Admin GraphQL APIRead full post –>We are deprecating productChangeStatus mutation. Use...
Tags:
- Shopify Theme Store
Theme cards being updatedRead full post –>Theme cards on the Theme Store have been updated. Theme cards are now:
- Visually simpler (feature tags have been removed)
- Have a link to the listing for the Theme title
- Have a badge...
Tags:
- Shopify Theme Store
Updating new Theme promotion periodRead full post –>We are extending the promotion period for new Themes. Now, new Themes will be highlighted for a longer period than before.
Tags:
- Themes
- Liquid
Link metafield type now supported in metafield Liquid filtersRead full post –>We've added support for the
Linkmetafield type to thefilter in Liquid.Furthermore, you can now consume
Linkmetafields using dynamic sources inand...Tags:
- Tools
Error messages available in the Shopify Pixel HelperRead full post –>We've added error messages to the Shopify Pixel Helper so that you can more easily debug your custom pixels. The Pixel Helper will display uncaught errors that occur at the top level or in the...
Tags:
- Action Required
- Admin GraphQL API
- 2024-10
Removing MetafieldStorefrontVisibility-related fields and mutations from Admin GraphQL APIRead full post –>GraphQL Admin API 2024-10 removes
fields, queries, and mutations. Usefor enhanced flexibility and functionality.Tags:
- Platform
Hydrogen August 2024 releaseRead full post –>Hydrogen v2024.7.3 enhances developer experience with .env support, performance boosts, simplified context creation, and config improvements. Includes bug fixes and new
prop.Tags:
- Admin GraphQL API
- 2024-10
Added newaccessargument tostandardMetafieldDefinitionEnableandstandardMetafieldDefinitionsEnableGraphQL mutationsRead full post –>GraphQL Admin API 2024-10 adds
accessargument for granular control in metafield mutations; deprecates. Update your code to useaccess.Tags:
- Action Required
- Platform
Notice of important updates to our Partner Program Agreement & API License and Terms of UseRead full post –>Updated Partner Program Agreement and API Terms effective Aug 9, 2024. Review changes to ensure compliance and support growth while maintaining security on Shopify's platform.
Tags:
- Action Required
- Admin GraphQL API
- Admin REST API
- 2024-10
Fulfillment Hold Release Access UpdateRead full post –>Admin API 2024-10 requires apps to have specific write scopes to release fulfillment holds. Insufficient access returns errors:
INVALID_ACCESSin GraphQL,422in REST. Update scopes accordingly.Tags:
- Shopify App Store
All categories now support structured app category detailsRead full post –>Specify app category features for better visibility on the App Store and in comparisons, aiding merchants in finding apps that meet their needs.
Tags:
- Admin GraphQL API
- Admin REST API
- 2024-10
Product category included in product webhooksRead full post –>The 2024-10 update adds a
categoryfield to product create/update webhooks. Use API version 2024-10+ in your App Partner Dashboard to receive this data.Tags:
- Platform
Partner payout schedule updateRead full post –>Effective from July 29, 2024, a 30-day hold will be applied to your first payout. This change will only impact new partners who have not yet received their first payout. Learn more about [payout...
Tags:
- Shopify App Store
30 more categories now support structured app category detailsRead full post –>Specify app features for 30 new categories on your listing page to enhance merchant discoverability and comparison. Full category support expected by August 2024.