Developer changelog

Merchants can now find your app via AI-powered guided search using natural language in the Shopify App Store. Ensure your app listing is accurate to reach the right audience.

Starting January 31, 2024, use shopify app deploy instead of shopify app config push for app configuration. Update CLI and CI/CD scripts to avoid breaking changes.

You can now subscribe to compliance topics using you app's [TOML configuration file] (https://shopify.dev/docs/apps/app-extensions/configuration) and use PubSub or Eventbridge URIs as your...

Updated App Design Guidelines: Revised full-screen mode to max modal; removed admin app block directive for summary property.

With the latest version of App Bridge, you can use the POS API. This provides the ability to retrieve the POS user, device, and...

As of 2024-04, the Abandonment.isFromCustomStorefront field has been released into stable version.

In preparation for supporting IPv6 on storefront domains, merchants and partners should update any third-party tools, such as firewall rules, to allow traffic in the CIDR range 2620:127:f00f::/48...

As of version 2024-01, you can use the GraphQL Admin API to get and set a firstName and lastName on the CompanyAddress.

From 2024-04, MarketWebPresence fields defaultLocale and alternateLocales will use ShopLocale type. Update API calls to access enhanced locale info.

As of Shopify CLI version 3.53+, you can use GraphiQL in the CLI while running app dev by simply pressing the g hotkey.

This GraphiQL instance uses your app's credentials, working with the...

With the latest version of App Bridge, you can use the filter query option with the Resource Picker API to filter...

The 2024-01 REST Order APIs update aligns channel_liable behavior with GraphQL, clarifying tax remittance responsibility. Defaults to false if unspecified.

As of API version 2024-01, we've added the CAPABILITY_VIOLATION error code to the MetafieldsSetUserErrorCode enum. This error code is returned if you attempt to update a metafield in a way that...

The 2024-01 Cart Transform API adds fixed pricing, custom titles, and images for bundles, plus an update operation for Plus merchants. blockOnFailure ensures critical function execution.

As of 2024-01 version in the admin GraphQL API, you can specify whether to include translations when calling the...

Admin API 2024-01 allows checkoutBrandingUpsert to reset branding to defaults using null in checkoutBrandingInput, simplifying the reset of branding settings and subfield groups.

API version 2024-01 fixes a bug allowing refunds on returns with REQUESTED status. Refunds are now blocked, ensuring accurate return processing.

The 2024-01 update introduces Scheduled Changes for inventory, aiding planning without auto-adjustment. Use new mutation inventorySetScheduledChanges to manage these changes effectively.

As of Admin API 2024-01, you can use the Checkout Branding API to customize the look of the ChoiceList components on your checkout with customizations.choiceList.

Learn more about the...

As of 2024-01 Metaobjects will be exposed as a MarketLocalizableResourceType. This means that...

As of 2024-01 the OrderTransaction endpoint now exposes the multiCapturable field, to inform whether a transaction can be captured multiple times.

Learn more about...

As of 2024-01, the line_items field on AbandonedCheckout GraphQL API will be available to public.

The 2024-01 GraphQL Admin API update renames fields, requires new inputs, and deprecates others. It adds bulk operations, supports external activity sync, and enhances data deletion and aggregation.

API 2024-01 removes acceptsMarketing, acceptsMarketingUpdatedAt, and MarketingOptInLevel. Use emailMarketingConsent instead for customer data handling.

Buy X Get Y discounts now support fixed amount discounts, usable with percentage/free item options. Available as automatic or code via Discounts GraphQL API.

As of API version 2024-01, you can use the marketRegionsDelete mutation to delete multiple market regions in a single mutation.

Learn more about markets on...

You can now add, remove, and update discounts on existing order items using new mutations, enhancing flexibility in order edits for developers.

New fields createdByApp and createdByStaff added to MetaobjectDefinition and Metaobject. staffMember in Metaobject deprecated; use createdByStaff instead.

API 2024-01 updates access controls for custom data, affecting reserved prefixes and app settings. Developers can configure access for admin and storefront, impacting data visibility and permissions.

GraphQL Admin API 2024-01 adds orderCancel mutation for async order cancellation with options for refund, restock, notifications, and notes. Track status via the job API.

AWAITING_RETURN_ITEMS The fulfillment hold is applied because of return items not yet received during an exchange.

The new hold reason is applied to a [fulfillment...

API Version 2024-01 introduces webhooks for Split/Merge, adds line item connections to FulfillmentOrderLocationForMove, and a new error code for missing line items in Split.

API v2024-01 adds orderId, orderName, orderProcessedAt, channelId to FulfillmentOrder and financialSummaries to FulfillmentOrderLineItem, enhancing order and financial data access.

As of API version 2024-01 of the GraphQL Admin API, your app can subscribe to metaobjects/create, metaobjects/update and metaobjects/delete.

These new webhook topics use sub-topics so you...

The 2024-01 GraphQL Admin and Customer API release allows single-operation updates to subscription status with new mutations like Activate, Pause, Cancel, Fail, and Expire.

As of the 2024-01 release of the GraphQL Admin API and GraphQL Customer API, you can update the skipped field of a subscription billing cycle in a single operation with the...

The 2024-01 GraphQL Admin API release adds webhook topics for subscription status changes: activate, expire, fail, cancel, and pause, enhancing real-time contract status tracking.

As of Admin GraphQL 2024-01, the SubscriptionContractSubscriptionStatus.STALE status...

As of the 2024-01 release of the GraphQL Customer API, you can fetch the available delivery options for a subscription contract with subscriptionContractFetchDeliveryOptions. And you can...

The 2024-01 GraphQL Admin API update blocks SubscriptionBillingAttemptCreate for terminal statuses and adds CONTRACT_TERMINATED error code to handle blocked attempts.

Using the TranslationsRegister GraphQL API, you can now register translations for Product types.

Product type...

API 2024-01 allows adding Metaobject page links to Storefront menus. Only Metaobjects with Renderable and OnlineStore capabilities can be used for Online Store URLs.

The 2024-04 Storefront API release adds deliveryAddressValidationStrategy for cart mutations, enabling strict or country-only address validation, impacting error handling and address storage.

Theme editor's richtext, text, and inline_text now support metaobject references. Liquid filters metafield_tag and metafield_text updated for dynamic sources, enhancing product detail customization.

As of the 2024-01 version of the Admin GraphQL API, you can filter the prices connection on [Price...

With the latest version of App Bridge, you can use the modal API with custom DOM content.

You can also use the new max modal...

API Version 2024-01 introduces the Shipping Discount Function API for all merchants. Deprecated: discountApplicationStrategy in FunctionRunResult and FunctionResult.

As of GraphQL Admin API version 2024-01 , you can use the ID field to identify an...

Partners can now build extensions for new customer account pages, enhancing order actions and profiles, in developer preview, improving user experience with seamless app navigation.

UI extensions using purchase.checkout.shipping-option-list.render-before/after won't render for mixed purchases. Use ShippingOptionListApi for delivery groups. New DeliveryGroup ID added.