Developer changelog

We're deprecating the TRANSPARENT value on the CheckoutBrandingBackground enum of the Admin GraphQL API checkoutBranding query and checkoutBrandingUpsert mutation. Use BASE or SUBDUED...

The 2024-07 Customer Account API adds metafieldsSet for resources, requiring explicit access permissions. Admin API updates allow setting access controls. Test on unstable APIs now.

GraphQL Admin API 2024-07 introduces DeliveryPromiseProvider for delivery estimates, available to approved partners. Use deliveryPromiseProviderUpsert mutation and query for management.

As of 2024-07, you can use the following metafields to save link related content:

• link: A link consisting of an anchor text and URL.
• list.link: A list of link metafields.

Learn more...

As of the 2024-07 version of the Admin GraphQL API, the id field in the ProductVariantSetInput will...

StoreCreditAccount queries and mutations are now global in the GraphQL Admin API, with transaction history access. Authenticated customers can view and use store credit at checkout.

GraphQL Admin API 2024-07 removes duplicate fields from Product Variants, affecting input types and webhooks. Developers should use Inventory Item fields for fulfillment, shipping, and weight details.

Admin API 2024-07 introduces new mutations and queries for bulk billing cycle management, enhancing subscription handling capabilities for developers.

API version 2024-07 adds jsonValue to Metafield and MetaobjectField, returning JSON scalars to enhance performance and simplify parsing in Function APIs and input queries.

GraphQL Admin API 2024-07 adds typOspPagesActive field to check if Thank You and Order Status Pages use extensibility or deprecated features, impacting UI and script usage.

GraphQL Admin API 2024-07 deprecates several Customer filters. Use segments for filtering by total_spent, orders_count, accepts_marketing, and more.

As of the 2024-07 version of the Admin GraphQL API, the variants and productOptions fields in the...

As part of the 2024-07 release, delivery-related discounts into the Storefront API's Cart discountAllocations field and a new targetType field have been added to differentiate the type of...

As of GraphQL Admin and Customer Account APIs version 2024-07, you can now set metafields using compare-and-swap (CAS) through the new compareDigest field for the metafieldsSet mutation.

...

GraphQL Storefront API v2024-07 adds oneTimeUse property to Cart for temporary delivery addresses, ideal for gifting scenarios, ensuring addresses aren't saved post-checkout.

As of 2024-07, when creating, updating or querying a webhook subscription you can now include a filter parameter. This parameter, which is specified using [Shopify Search...

As of 2024-07, the subTopic argument has been removed for creating webhook subscriptions. For creating subscriptions that previously required a subTopic the filter argument should be used instead....

Web pixels now capture more data fields, enhancing integration performance. New fields include country code, payment settings, discount amounts, and marketing consent options.

Shopify webhoks are first-class citizens with our APIs, and we now finally have a reference experience too! Now, all of Shopify's webhook topics are...

Webhooks are now managed by Shopify! Configure app-specific subscriptions as opposed to per shop. Using Shopify CLI v3.63.0 or later, add, modify and deploy app-specific subscriptions in your app...

The cart token in Shopify's Ajax API now includes a key param. Update code to avoid format assumptions and ensure compatibility with external databases by storing the full token value.

Build extensions on the pre-authenticated Order Status Page in Shopify's Customer Account Extensibility Developer Preview for consistent customer experiences, regardless of authentication state.

The update allows adding, removing, previewing, and repositioning customer account UI extensions, grouping them into collections, and setting default placements for enhanced customization.

Use the Customer Account API to write and access customer data via metafields, allowing logged-in customers to update their info directly in Shopify.

As of Shopify CLI 3.63, log streaming and replay for Shopify Functions is available in beta.

Log streaming for Shopify Functions enables faster development, testing, and debugging of functions...

Developers can now use Shopify CLI to create and contribute templates to Flow's library, enhancing store automation. Configure, preview, and deploy templates for approval and library inclusion.

Updated App Design Guidelines: FullscreenBar deprecated, proper grammar and Contextual Save Bar API are mandatory. New section added for subscription app requirements.

Managed pricing simplifies app pricing setup via the Partner Dashboard, automating billing tasks and enabling easy discounts and trial extensions, with automated merchant notifications.

Developers can now integrate admin print actions in Shopify apps, enabling seamless printing of documents like invoices directly from Order and Product pages in the Shopify admin.

Shopify App Store Ads’ metrics now update in real-time. Partners will get immediate feedback when they refresh their ad report on their ads’ performance as auctions, impressions, clicks, and...

GraphQL Admin API 2024-07: Create, update, delete, and query menus with new mutations and queries, enhancing menu management capabilities for developers.

Structured app category details now support 30 more categories, enhancing app-merchant matching, ad bidding, and discovery. Update fields on app listing pages for improved results.

JSON editing in Liquid themes now supports trailing commas and comments, simplifying refactoring. Apps parsing JSON should adapt to these changes for compatibility.

The new ProductOptionValue type and optionValues field in the API replace values, offering enhanced option details like swatches, improving data retrieval for developers.

As of 2024-10, OrderDisplayFulfillmentStatus will now return REQUEST_DECLINED for an order that has had...

As of 2024-07, you will receive a detailed error message when missing payment information for [subscriptionDraftCommit...

GraphQL Admin API v2024-07: draftOrderLineItemInput now supports bundleComponents, enabling apps to manage bundle items in drafts. CartTransform auto-runs on all draft orders.

Released new Taxonomy API with TaxonomyCategory type, updated product types, added category field to ProductInput, and deprecated shop.allProductCategories.

UI Extensions 2024-07 support split shipping with new API targets and deprecated methods. Update logic for delivery groups and render modes. Compatible with 2024-01 and 2024-04.

App taxonomy updated for better discoverability. Review new categories, update your app's category, and check ad campaigns for potential impacts. One-time category change allowed.

As of 2024-07, you can use the RefundLineItem.id to return the id of specified RefundLineItem object.

Learn more about working with RefundLineItem on...

The CartLinesUpdate mutation behavior has been updated to preserve...

As of 2023-04, the default sort key for discountNodes, codeDiscountNodes, and automaticDiscountNodes queries has changed to ID. Previously the default sort key was CREATED_AT. This change...

As of 2024-07, we're deprecating buyerIdentityInput.walletPreferences. Use buyerIdentityInput.preferences.wallet instead.

Learn more about these changes on...

Discount Functions now support B2B draft orders, allowing discounts at checkout for B2B buyers. This enhances flexibility and efficiency in B2B transactions.

It is now possible for merchants to share all function run details for an app within the last 24 hours with the app developer. This will share function run details for every function on the app,...

We are adding a limit to the number of fulfillment constraint rules that can be applied to a shop - currently, this limit is 10. As a result, we are also adding a new error code to the API.

As...

Hydrogen v2024.4.3 introduces useOptimisticCart hook, <RichText /> component, stable analytics, and upgrades to Remix 2.9.2, enhancing developer tools and performance.

POS app v9.10 supports advanced Discount Functions, enabling automatic discounts, smart grid tiles, and improved error handling, enhancing developer flexibility and merchant capabilities.

API v2024-07 adds url_parameter_value for tracking in MarketingActivityCreate/Update. MarketingActivityUserError is now required for MarketingEngagementCreate errors.