Developer changelog

App subscription plans now include persistent plan handles, making it easier to query for plan data.

API version 2025-04 adds fees and net fields to the GraphQL and REST Admin APIs for adjustment orders, which are helpful for financial reconciliation in balance transactions

API version 2025-04 lets you manage shop privacy settings, including cookie banners, data sale opt-outs, and privacy policy automation.

As of GraphQL Admin API version 2025-04, the defaultEmailAddress field is introduced on the Customer object to support querying a customer's email address and marketing state.

Learn more...

As of API version 2025-04 of the GraphQL Admin API, the productSet and customerSet mutations can upsert by identifier, simplifying record management.

Added rfmGroup field to customer statistics in the Admin GraphQL Admin API to expose customer segmentation data based on purchasing patterns.

The themeFilesUpsert mutation now returns theme file metadata directly, eliminating the need for extra fetch requests to verify updates.

We've added new FulfillmentOrderRejectionReason enum values for more detailed error messages.

Added new enum values to CustomerPaymentMethodRevocationReason: CUSTOMER_REDACTED, TOO_MANY_CONSECUTIVE_FAILURES, CVV_ATTEMPTS_LIMIT_EXCEEDED

Shopify-approved finance apps can access shop finance details and subscribe to related webhooks

As of Admin API 2025-05, we have introduced new error codes that will be returned from the combinedListingUpdate mutation. These new errors are to provide more clarity when the mutation is called...

Use the giftCardConfiguration query to retrieve the maximum values for purchased and issued gift cards.

articles, pages, and comments queries now have full filter parity with the REST Admin API

To fetch a list of article authors for a store, use the new articleAuthors query.

API version 2025-04 introduces the include_mirrored_exchanges query filter parameter, which provides greater flexibility in managing and viewing exchange data.

Starting from 2025-04, unused PriceListErrorCode values will be removed.

2025-04 adds customerAddressCreate, customerAddressUpdate, and customerAddressDelete mutations for more granular control on customer addresses.

As of 2025-04, the X-Shopify-API-Deprecated-Reason HTTP header will return the list of detected deprecations instead of a generic URL.

New metafield namespaces and metaobject types can not have prefixes that end with double hyphens (e.g., "foo--"). Existing definitions remain unaffected.

API version 2025-04 introduces the ends_at, created_at, and updated_at query filter parameters, which provides greater flexibility in managing and viewing discounts.

Adds NonTestOrderLimitReached field to SubscriptionBillingAttemptErrorCode, alerting you when you've exceeded the order limit for a payment processor.

As of 2025-04, Product Variant mutations will validate country harmonized system codes against existing inventory item harmonized system codes.

Use the GraphQL Admin API to query the retail location where customers are updating their marketing consent.

RELEVANCE will no longer be included in connection sort options by default as of 2025-04. This will eliminate cases where the option offered no unique behavior.

As of 2025-04 partial payments can be recorded on orders using the new orderCreateManualPayment mutation....

Payout statuses "In Transit" and "Scheduled" are now merged as "Scheduled." Update workflows to recognize "Scheduled" for accurate payout info. Change is effective immediately.

Catalog APIs now support multiple markets per catalog. Use type: REGION to maintain single market behavior.

API v2025-04 now supports filtering subscriptionContracts by created_at, updated_at, and status in admin and customer APIs.