Developer changelog

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.

Discount functions now support prerequisites for BXGY discounts, allowing developers to specify "Buy X" conditions.

API version 2026-04 introduces tags for discounts, enabling efficient labeling and organization.

App-owned metaobjects now require no access scopes, simplifying developer use. Ensure Admin API version 2026-04+ for this feature. Merchant-owned metaobjects still need specific scopes.

Added access field to StandardMetaobjectDefinitionTemplate for visibility of access rules, aiding developers in planning API interactions and ensuring smooth integration.

Polaris reference docs now align with Shopify's GraphQL versioning, supporting each stable version for 12 months. Only the last four versions will have published docs starting 2026-04.

The delegateAccessTokenCreate GraphQL mutation now returns an expiresIn field on the DelegateAccessToken type.

Adds a components field to DraftOrderLineItem. New optional flattenComponents argument defaults to false, affecting line item hierarchy.

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.

API v2026-04 adds billing address and PO number validation in Cart/Checkout Functions, enabling compliance checks without client-side UI. Existing functions remain unaffected.

Sales channel apps can now manage multiple connections within one app, each with distinct specs and accounts. New APIs support channel creation and management, enhancing flexibility and integration.

As of API v2026-07, customerPaymentMethodRemoteCreate requires a payment method ID for Stripe, Authorize.net, and Braintree. Update integrations to include these IDs.

API v2026-04 allows 3PLs and apps to report fulfillment order progress using fulfillmentOrderReportProgress. Supports status notes for OPEN/IN_PROGRESS orders, enhancing merchant visibility.

In API 2026-04, paymentMethodId is optional for subscription contract creation, easing migration of contracts with missing or expired payment methods to Shopify.

In API 2026-04, paymentProcessingPolicy in subscriptionBillingAttemptCreate allows creating unpaid orders without valid payment methods.

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

RBAC and a new organization structure for partner orgs. All stores in Dev Dashboard. Auto-migration starting March 30th - no action required.

Shopify CLI will remove the --force flag in May 2026 to prevent accidental app extension deletions. Update CI/CD scripts to use --allow-updates for safer deployments.

Customer data erasure requests will process 10 days after submission, regardless of last order date; gift card recipients remain pending until delivery.

The pre_tax_price fields in REST Admin API are removed. Use GraphQL Admin API for order line item pricing. Avalara AvaTax 1.0 integration deprecated April 2025.

Version 2026-04 adds barcode support to inventory shipments, enabling faster receiving. New API fields and mutations allow assigning, setting, or clearing unique barcodes up to 255 characters.

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.

POS UI extensions now run without network access. Enable by setting runs_offline = true. Requires POS v11.0+ and Shopify CLI v3.92+.

The inventoryTransferDelete mutation returns INVALID_STATE error in 2026-07 if a product import is in progress. Older versions lack this code but include context in the message field.

Payments Apps API now offers detailed decline codes and a source field for rejected payments, aiding developers in providing precise feedback to merchants. RISKY code deprecated; use FRAUD_SUSPECTED.

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

New development shops have access to checkout and customer account UI extensions by default. Existing shops remain unchanged.

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.

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

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.

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