Developer changelog

You can now enable standard metafields on a shop using namespace and key with our GraphQL API.

Learn more about [standard...

As of GraphQL Storefront API version 2022-07, a new urlRedirects object has been added.

URL redirects can be used to redirect traffic from one web page to another. The new urlRedirects...

Migration deadline for 2022-04 API extended to June 30, 2023. Fulfillment API endpoints deprecated; switch to Fulfillment Orders API by 2023-07. Migration guide available.

GraphQL API 2022-07 adds reason and lineItems to fulfillmentOrderRejectFulfillmentRequest mutation, plus a warnings field to FulfillmentOrderLineItem for rejection insights.

Storefront API 2022-07 deprecates HasMetafields.metafields pagination. Now filter by namespaces/keys. Available in unstable, stable in 2022-07. Old behavior in 2022-04 and earlier.

The 2022-07 Admin API adds a boolean field, MailingAddress.coordinatesValidated, to check if mailing address coordinates are validated, aiding fulfillment holds on unvalidated addresses.

In API 2022-07, ProductVariant can use multiple fulfillment services. Avoid using fulfillment_service fields; use inventory items/levels. presentment_prices is deprecated.

In API 2022-07, ProductVariant can use multiple fulfillment services. Avoid deprecated fields; use inventory items/levels. REST API origin_location, destination_location, and total_price_usd deprecated.

The 2022-07 Admin GraphQL API now validates the phone field in subscriptionContractCreate and subscriptionDraftUpdate, ensuring correct formatting and reducing payment errors.

GraphQL Storefront API 2022-07 update: Cart.discountAllocations now applies to entire cart, CartLine.discountAllocations to specific lines. CartLine.total reflects line-level discounts only.

Use the delegateAccessTokenCreate mutation to generate tokens with minimal scopes, enhancing security by avoiding shared tokens across systems in multi-subsystem app architectures.

API version 2022-07 adds a Braintree input field to CustomerPaymentMethodRemoteInput, aiding migration of Braintree subscription contracts to Shopify via customerPaymentMethodRemoteCreate.

The SKU sharing feature allows fulfillment apps to stock variants at multiple locations. Use permits_sku_sharing to enable this, but update apps using fulfillmentService to avoid issues.

Shopify introduces App Usage Spending Limits, allowing merchants to adjust cappedAmount. Developers should use webhooks for updates and note changes to the balance_used endpoint.

API version 2022-10 introduces new requirements for apps using customer data, focusing on data minimization, transparency, and security to enhance compliance support.

As of GraphQL Storefront API version 2022-07, the CartLineEstimatedCost object has two new fields: amount and compareAtAmount. Both fields return an object of type MoneyV2. These new fields...

From API v2022-07, GraphQL schemas use "@deprecated" for deprecated fields. Ensure your client supports this. Older versions use descriptions for deprecation warnings.

As of GraphQL Storefront API version 2022-07, the Cart object has a new field: totalQuantity. This field returns an integer representing the total number of items in the cart.

Learn more...

As of GraphQL Admin API version 2022-07, a new statistics field has been added to the Customer object for computed customer statistics. It includes a new field predictedSpendTier which...

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...

GraphQL Admin API 2022-07 now supports modifying discount combination settings, enabling multiple discounts per order. Available in Checkout extensibility developer preview.

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.

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.

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...

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.

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.

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...

GraphQL Admin API 2022-07 adds an optional cutoff_day to SellingPlanAnchorInput for fixed monthly/weekly cutoffs. Alternatively, use cutoff for variable monthly cutoffs.

GraphQL Storefront API 2022-07: Added attribute field to Cart; renamed estimatedCost to cost; updated CartCost fields; renamed amount fields in CartLineCost.

GraphQL Admin API 2022-07 lets developers choose update behavior for app subscriptions, controlling immediate or deferred activation. Default behavior remains unchanged.

The 2022-07 Storefront API release removes deprecated checkout mutations. These remain in 2022-04 until April 2023. Update your integrations accordingly.

Shopify CLI now allows theme previews using any store theme with -t flag. Ensure to pull remote themes first to avoid overwriting changes.

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...

GraphQL Admin API unstable now supports custom content per market, enabling localized terms and market-specific promotions, enhancing buyer engagement and localization.

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:...

Google Pay payments are now accepted for recurring transactions. For these transactions, the CustomerCreditCard will have a source of google_pay.

For more information, refer to [Building...

Templates now support up to 25 sections and 50 blocks per section, enhancing flexibility for FAQs, profiles, and large collections. Use max_blocks to set lower limits.

The TranslationsRemove endpoint now supports deleting translations that are stored in asset files.

Learn more about [the TranslationsRemove...

GraphQL Storefront API 2022-04 adds checkoutChargeAmount to Cart, showing immediate checkout subtotal. Available under extend_selling_plans_api beta flag.

A new Liquid app object is available for use within the context of theme app extensions and app proxies. The app object can be used to access an app's...

App block visibility in theme app extensions can now be controlled by custom conditions using the available_if attribute, with state stored in an app-owned metafield.

GraphQL connections now support a nodes field, simplifying queries. PageInfo adds startCursor and endCursor, enhancing pagination and data return efficiency.

GraphQL and REST Admin APIs v2022-04 add fulfillBy, maxDeliveryDateTime, and minDeliveryDateTime to FulfillmentOrder and DeliveryMethod, enhancing order and delivery scheduling.

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.

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 countries field on the...

The Shopify Markets API (v2022-04) lets developers manage markets and settings, enhancing localized buyer experiences with custom domains, languages, currencies, and pricing.

As of GraphQL Admin API version 2022-04, a new checkoutCharge field has been added to sellingPlan. It consists of a charge type (either percentage or price), and an amount, indicating how...

GraphQL Admin API 2022-04 lets developers issue prorated credits on app subscription cancellations, reducing refund support requests.

As of GraphQL Admin API version 2022-04, checkoutChargeAmount and remainingBalanceChargeAmount fields have been added to sellingPlanAllocation. These fields indicate how much of a product...

You can now create videos and transcode them to multiple formats, using the...