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:
- Tools
Introducing Checkout ExtensibilityRead full post –>With Checkout Extensibility, you can now build apps to customize checkout and Shop Pay. You can leverage Checkout UI extensions and Shopify Functions to surface new functionality, Checkout Branding...
Tags:
- API
- 2022-07
Apply multiple discounts to an order with discount combinationsRead full post –>GraphQL Admin API 2022-07 now supports modifying discount combination settings, enabling multiple discounts per order. Available in Checkout extensibility developer preview.
Tags:
- Tools
Introducing Shopify FunctionsRead full post –>Shopify Functions lets you extend or replace key parts of Shopify’s backend with custom logic. Functions run on Shopify infrastructure, making them both scalable and performant.
Functions are...
Tags:
- Tools
Embedded App Improvements with App BridgeRead full post –>App Bridge updates boost app integration with Shopify: 85% faster mobile loading, full-screen mode for complex tasks, and embedded navigation for seamless admin access.
Tags:
- Tools
Introducing Shopify CLI 3.0Read full post –>Shopify CLI 3.0 simplifies development with fewer commands, supports single projects for apps and extensions, and allows unified preview and deployment with one command.
Tags:
- Platform
App distribution decoupled from app creation, new Partner Dashboard navigationRead full post –>App distribution is now separate from creation in the Partner Dashboard. New navigation, a Distribution page, and CLI command copy-paste features enhance developer workflow.
Tags:
- API
- 2022-07
New API for collecting deferred payments on ordersRead full post –>As of GraphQL Admin API version 2022-07, we have introduced new APIs that enable you to collect deferred payment on an order using a vaulted card belonging to the customer. The...
Tags:
- API
- 2022-07
Selling Plan API now supports pre-orders and try before you buyRead full post –>GraphQL Admin API 2022-07 expands Selling Plan API, adding fields for deferred purchases like pre-orders. Enhance Shopify Checkout with flexible selling options using sellingPlanGroupCreate.
Tags:
- API
- 2022-07
Selling plans can now specify a fixed cutoff day for a delivery policyRead full post –>GraphQL Admin API 2022-07 adds an optional
tofor fixed monthly/weekly cutoffs. Alternatively, usecutofffor variable monthly cutoffs.Tags:
- API
- 2022-07
Changes to Cart and CartLine on Storefront APIRead full post –>GraphQL Storefront API 2022-07: Added
attributefield toCart; renamedtocost; updatedfields; renamedamountfields in.Tags:
- API
- 2022-07
New options for app subscription upgrades and downgradesRead full post –>GraphQL Admin API 2022-07 lets developers choose update behavior for app subscriptions, controlling immediate or deferred activation. Default behavior remains unchanged.
Tags:
- Action Required
- API
- 2022-01
Removal of Deprecated Storefront API Checkout MutationsRead full post –>The
2022-07Storefront API release removes deprecated checkout mutations. These remain in2022-04until April 2023. Update your integrations accordingly.Tags:
- Tools
Shopify CLI: Preview your theme changes using any themeRead full post –>Shopify CLI now allows theme previews using any store theme with
-tflag. Ensure to pull remote themes first to avoid overwriting changes.Tags:
- Action Required
- API
- 2022-07
Support for the XML response format is deprecated from the Admin REST APIRead full post –>Starting in version 2022-07, support for the XML response format and XML payloads in the Admin REST API is removed. Requests expecting an XML response will result in a 404. Requests that send an...
Tags:
- API
GraphQL Admin API now supports custom content by marketRead full post –>GraphQL Admin API
unstablenow supports custom content per market, enabling localized terms and market-specific promotions, enhancing buyer engagement and localization.Tags:
- Platform
Support added for compressed GIF imagesRead full post –>A much wider range of optimized GIFs, including LZW compression, are now accepted for upload.
To learn more about which image formats Shopify accepts refer to:...
Tags:
- API
Subscription apps support Google PayRead full post –>Google Pay payments are now accepted for recurring transactions. For these transactions, the
will have a source of.For more information, refer to [Building...
Tags:
- API
- 2022-04
TranslationsRemove endpoint now supports removing asset translation keysRead full post –>The
endpoint now supports deleting translations that are stored in asset files.Learn more about [the
...Tags:
- Platform
Themes now support 25 sections per template and 50 blocks per sectionRead full post –>Templates now support up to 25 sections and 50 blocks per section, enhancing flexibility for FAQs, profiles, and large collections. Use
to set lower limits.Tags:
- API
- 2022-04
New checkoutChargeAmount field added to Cart object on Storefront APIRead full post –>GraphQL Storefront API 2022-04 adds
toCart, showing immediate checkout subtotal. Available underbeta flag.Tags:
- API
New app Liquid objectRead full post –>A new Liquid
appobject is available for use within the context of theme app extensions and app proxies. Theappobject can be used to access an app's...Tags:
- API
- 2022-04
Theme app extensions now support conditional app blocksRead full post –>App block visibility in theme app extensions can now be controlled by custom conditions using the
attribute, with state stored in an app-owned metafield.Tags:
- API
- 2022-04
New value for the DigitalWallet enumRead full post –>As of API version 2022-04, the
enum has a new value,FACEBOOK_PAY. This change affects both GraphQL Admin and Storefront APIs.For more information, refer to the...
Tags:
- API
- 2022-04
App-owned MetafieldsRead full post –>As of GraphQL Admin API version 2022-04, a new owner type
is now available for metafields. A metafield with this permission type will only be readable and writable by the app that...Tags:
- API
- 2022-04
New field deliveryGroups for the cart objectRead full post –>GraphQL Admin API 2022-04 adds
tocartfor logged-in users with a default address, offering delivery options for line items based on the shipping address.Tags:
- API
- 2022-04
New checkoutCharge field added to the Storefront API sellingPlan objectRead full post –>As of GraphQL Admin API version 2022-04, a new
field has been added to. It consists of a charge type (eitherpercentageorprice), and an amount, indicating how...Tags:
- API
- 2022-04
New email marketing consent for customers and deprecated fieldsRead full post –>API v2022-04 deprecates
fields. Update apps to useandfor detailed consent data. Adjust GraphQL and REST API integrations.Tags:
- API
Deprecated fields on the Customer objectRead full post –>GraphQL Admin API
Customerobject updates:is now,fields replaced by, andandremoved.Tags:
- API
- 2022-04
New menu field in the Storefront APIRead full post –>As of the 2022-04 version of the Storefront API, you can fetch a navigation menu by handle with the
menufield. The new field returns a...Tags:
- API
- 2022-04
New value for the FilterType enumRead full post –>As of API version 2022-04, the GraphQL Admin API's
enum has a new value(BOOLEAN). TheBOOLEANvalue is assigned when a filter is based off abooleantype metafield definition....
Tags:
- API
- 2022-04
Storefront API @inContext directive supports languagesRead full post –>In version 2022-04,
in Storefront API now supports alanguageargument, enabling localized queries. Unsupported requests default to available settings.Tags:
- API
- 2022-04
Attribute orders to a sales channelRead full post –>Admin API 2022-04 adds
andto Orders and Checkout in REST/Graph APIs.update enables order attribution to sales channels.Tags:
- Action Required
- API
- 2022-04
New pending mutation in Payments Apps API 2022-04 releaseRead full post –>The 2022-04 Payments Apps GraphQL API release adds a pending payments mutation, restricts merchant actions during pending status, and deprecates the
statusfield forstate.Tags:
- API
- 2022-07
New SEO field on the Storefront API Collection objectRead full post –>As of GraphQL Storefront API version 2022-07, the
Collectionobject has a new field:SEO. This field returns anSEOobject.Learn more about [this API on...
Tags:
- API
- 2022-04
New fields for custom attributes added to subscription contractsRead full post –>The 2022-04 Admin GraphQL API adds
to,, and, enabling custom attribute updates for subscription orders.Tags:
- API
- 2022-04
New field originTime for subscriptionBillingAttemptRead full post –>GraphQL Admin API 2022-04 adds
to, allowing billing date overrides to prevent fulfilment delays when billing is late.Tags:
- API
- 2022-04
New enum value for CustomerPaymentMethodRevocationReasonRead full post –>As of GraphQL Admin API version 2022-04, the CustomerPaymentMethodRevocationReason object has a new enum value: MERGED. This value is assigned when a customer replaces one payment method with...
Tags:
- API
- 2022-04
New: Markets APIRead full post –>The Shopify Markets API (v2022-04) lets developers manage markets and settings, enhancing localized buyer experiences with custom domains, languages, currencies, and pricing.
Tags:
- Action Required
- API
- 2022-04
Deprecating countries field on PriceListContextRuleInputRead full post –>With the launch of the Markets API as of version 2022-04, price lists are no longer associated with a country, but with a market. We've deprecated the
countriesfield on the...Tags:
- API
- 2022-01
Videos in Files and MetafieldsRead full post –>You can now create videos and transcode them to multiple formats, using the...
Tags:
- API
- 2022-04
new checkoutChargeAmount and remainingBalanceChargeAmount fields on Storefront APIRead full post –>As of GraphQL Admin API version 2022-04,
andfields have been added to. These fields indicate how much of a product...Tags:
- API
- 2022-04
Providing app credits in the appSubscriptionCancel mutationRead full post –>GraphQL Admin API 2022-04 lets developers issue prorated credits on app subscription cancellations, reducing refund support requests.
Tags:
- Shopify App Store
- 2022-04
New app billing discounts and app trial extensionsRead full post –>New GraphQL Admin API features: offer recurring app discounts and extend trial days to attract merchants. Discounts apply for set billing cycles; trial extensions available in unstable API version.
Tags:
- API
Enhancements to pagination for GraphQL connectionsRead full post –>GraphQL connections now support a
nodesfield, simplifying queries.addsand, enhancing pagination and data return efficiency.Tags:
- API
- 2022-04
New fulfillment information API fields for fulfill by and expected delivery timeRead full post –>GraphQL and REST Admin APIs v2022-04 add
,, andtoand, enhancing order and delivery scheduling.Tags:
- Tools
Online Store 2.0: Two-way sync support on Shopify CLIRead full post –>Theme developers can now use the Shopify CLI
theme servecommand with the new--theme-editor-syncflag. When active, theme editor changes are automatically synced back to the local development...Tags:
- API
Updates to error codes for translationsRegisterRead full post –>In GraphQL Admin API v2022-04,
INVALID_LOCALE_FOR_SHOPnow indicateslocaleerrors inTranslation. Older versions useINVALID_CODEfor these errors.Tags:
- Tools
CI/CD support for scripts, extensionsRead full post –>Developers can now programmatically push their scripts and extensions to Shopify from their CI/CD pipelines with CLI authentication tokens.
For more information on how to set up CI/CD for your...
Tags:
- Themes
New theme editor setting types: product list and collection listRead full post –>Two new input setting types have been added to the theme editor:
and. They allow merchants to quickly create curated, ordered and paginatable lists of products and...Tags:
- API
- 2022-04
Changes to metafield definition error codesRead full post –>As of GraphQL Admin API version 2022-04, an error returns when a metafield definition is created with invalid characters in either the
keyor thenamespacefields. Thekeyandnamespace...