Developer changelog

New Admin GraphQL shippingLabelPurchase mutation lets apps buy Shopify Shipping labels asynchronously for fulfillment orders

The totalUnsettledSet field now correctly calculates unsettled amounts for pending captures, fixing a double-counting bug in multi-capturable orders. No code changes needed.

We’ve made a number of changes to discount fields in the Storefront Cart GraphQL API for better clarity in discount allocations.

Shopify POS now supports custom cash management with new GraphQL APIs and UI extensions. Features include shared cash drawers, enhanced financial data, reason codes, and bulk export capabilities.

From GraphQL API v2026-04, Shopify Functions can access metaobject entries, enabling queries for structured data like tiered pricing and bundles using a handle or ID in input queries.

GraphQL Admin API now supports querying translated metafield values for any resource. Use the translations field to retrieve localized content. Supports text-based metafield types.

The productUpdate mutation now accepts an identifier argument for looking up products by id, handle, or customId.

Starting April 1, new public apps must use expiring offline access tokens to improve security. This affects only public apps using the Admin API with non-expiring tokens, not merchant or custom apps.

Shopify apps must process refunds via the original payment processor. Use 'refundCreate' or 'returnProcess' for store credits to ensure secure, consistent handling within Shopify.

Admin intents now support direct access to Shopify Settings pages via API calls, streamlining merchant navigation and enhancing app integration with specific settings like StoreDetails and Locations.

The fieldDefinitions input argument of the metaobjectDefinitionCreate mutation will become optional in 2026-04.

The createdAt and updatedAt fields will become available in API version 2026-04

Returns fields in analytics are deprecated and replaced with renamed versions (e.g., sales reversals) in API version 2026-04 to better reflect all order adjustments; update your queries before removal

We’ve clarified the requirements for App Store listing images to provide more consistent guidance on what’s expected

The inventorySetScheduledChanges mutation is being removed with no replacement. Remove its usage to prevent disruptions. Consider inventoryAdjustQuantities for immediate inventory updates.

As of version 2026-04, we removed the id field from checkouts webhooks and the checkout_id field from orders webhooks. From now on, use the checkout token to reference a checkout.

New features include product tagging for UGC, SafeArea support, CLI enable/disable commands, improved consent flow, scope simplification, and a quick link for minis on the Shop App home screen.

The analyticsQueryable feature in GraphQL Admin API lets developers enable metafields for Shopify Analytics, enhancing data analysis for Products, Product Variants, Orders, and Customers data.

In GraphQL API v2026-04, Shopify Functions can now access discount details at cart, line item, and delivery levels, but only if they execute after discounts are applied.

Asset caching update ends support for bare query strings in URLs for cache busting. Use Liquid filters like asset_url to ensure assets refresh correctly and improve load times.

developer change log for the updates to the API TOS and PPA

Accelerated checkouts now support purchasing products with add-ons directly from the product page, enhancing the buying process for developers integrating payment solutions.

Legacy customer accounts are no longer available to all new stores. All merchants are recommended to upgrade to the latest version. Build the future of customer accounts with us.

You can now pass locale and region_country parameters to the Customer Account API authorization endpoint to build market-aware login URLs in headless storefronts.

New APIs support multiple tiered rates for shipping options. Migrate to new fields to avoid issues. Legacy fields will be deprecated.

Shopify CLI 3.91 updates Dev Console to show all active dev previews, creator info, and last updates. Access preview links, QR codes, and clean up unused previews easily.

The GraphQL Admin API now includes SubscriptionBillingAttemptState, replacing several fields with a discriminated union for better ergonomics and self-documentation.

The Payments Apps API now supports new rejection codes and an optional merchant message, enhancing control over verification rejections with moredetailed reasons and custom feedback.

JSON metafield values will be capped at 128KB beginning with API version 2026-04.

Enhanced monitoring: 30-day webhook history, topic filtering, precise log time filters, multi-select options, and event counts improve debugging and visibility in the Dev Dashboard.

Shopify CLI 3.90.1 adds commands for executing queries, mutations, and bulk operations, enhancing automation and data handling for developers using the Admin API.

The Dev Dashboard now supports all Shopify admin languages, rendering in your preferred language for enhanced usability.

A new remainingLineItemsWeight field has been added to the FulfillmentOrder GraphQL type.

Added 3 enum values to ColumnDataType: RATING (float), STRING IDENTITY (GID/UUID), COLOR (HEX). Enhances data representation flexibility for developers.

Assign optional names to webhook subscriptions for easier management. Names appear in request headers, aiding routing. Unique per shop/app, up to 50 chars, set via TOML or Admin API.

The shopify.app.extensions() method now supports Point of Sale UI extensions, enabling consistent data handling and easier onboarding for in-store app experiences.

The Hydrogen January 2026 release updates the Storefront and Customer Account APIs to 2026-01. The cartDiscountCodesUpdate mutation now requires the discountCodes argument.

Query gift card expiration settings via GraphQL Admin API. New expirationConfiguration field provides duration and unit, aiding in calculating expiration dates for gift cards.

Shop Minis January 2026 updates: Delayed consent popup, curated Explore screen, CLI dashboard command, product list privacy controls, and UGC documentation

New payment error codes in Admin GraphQL API enhance diagnosis. Unstable API version shows fewer generic errors. Temporary error mapping issue fixed.

Order metafield definitions now support cartToOrderCopyable. When enabled, cart metafield values copy to the matching order metafields at checkout completion.

We've added a tracks_inventory filter for querying products by inventory tracking status.

You can now define up to 30 app blocks in your theme app extension, up from 25.

The Hydrogen October 2025 release updates the Storefront and Customer Account APIs to 2025-10 and adds cart mutations for appending gift card codes and replacing delivery addresses.

POS version 10.19.0 now displays an error page for unhandled callback errors. Developers must test callbacks to ensure all exceptions are properly handled and prevent merchant disruptions.

Access to events data over a year old is removed from Admin GraphQL and REST APIs. Update dependencies to ensure compatibility. This change enhances data management and system performance.

Checkout UI extensions that support blocking will now default to non-blocking behavior. Merchants must explicitly activate blocking behavior.

Theme developers can now use the article_list setting type to let merchants select multiple blog articles for sections and blocks.

Shopify CLI 3.89 adds --allow-updates and --allow-deletes flags for safer app deployment control in CI/CD. Use --allow-updates to avoid accidental data loss.

In API version 2026-04, permitsSkuSharing is removed from FulfillmentService. Permits SKU sharing will be enabled by default.