Developer changelog

Checkout forms now support street name, number, and neighborhood fields based on country. Developers can test these in the Checkout Extensibility preview before merchant rollout.

The Cart Ajax API now uses a unified error message: "You can't add more name to the cart." This affects update.js, change.js, and add.js endpoints.

Storefronts now use hCaptcha, allowing CAPTCHA binding via markup or JavaScript. Invalid CAPTCHA submissions return a 400 error, impacting form handling for App/Theme developers.

As of July 18, 2024, Shopify APIs support accurate refunds for orders with multiple shipping lines, detailing each refund in both GraphQL and REST APIs for improved data accuracy.

In the 2024-10 Admin GraphQL API, productDeleteAsync is removed. Use productDelete with a synchronous parameter to choose sync or async deletion, and track async status via operation ID.

In version 2024-10, the productDuplicateAsyncV2 mutation is removed. A new synchronous parameter in productDuplicate allows async duplication with operation tracking via ProductOperation.

GraphQL Admin API 2024-10 deprecates singular variant mutations in favor of bulk versions: use productVariantsBulkCreate, productVariantsBulkUpdate, and productVariantsBulkDelete instead.

As of Juy 16th, the structured_data filter outputs product information using the [ProductGroup schema.org...

As of the GraphQL Admin API version 2024-10, we're deprecating the GREATER_THAN_ZERO and INVALID_LINE_ITEM_QUANTITY error codes on the [fulfillmentOrderReleaseHold...

Hydrogen v2024.7.1 adds useOptimisticVariant hook, sellingPlanId for <BuyNowButton />, new session pattern, improved <VariantSelector />, Remix 2.10.0, and Vite CLI updates.

Added Product.restrictedForResource field to query product restrictions in CalculatedOrder, showing status and reason. Supports Managed Markets restrictions during order edits.

As of 2024-10, CartTransform create mutation supports metafields, enabling setting them at creation, reducing the need for additional calls, streamlining the process for developers.

The 2024-07 API introduces an instructions API to check extension API availability, requiring fail-safes for unsupported APIs in checkout UI extensions for draft order invoices.

GraphQL Admin API 2024-07 lets you set/query customer data sale/sharing opt-out status, aiding compliance with US laws like CCPA/CPRA.

As of the 2024-07 release of the GraphQL Admin API, a new error code LEDGER_DOCUMENT_INVALID will be added to the potential errors for the...

As of 2024-07, you can use the Order.transactionsCount to return the number of transactions associated with a given order.

As of 2024-07, you can use the fileUpdate mutation to connect files to products.

Learn more about working with files on...

From 2024-07, GraphQL's FulfillmentOrderLineItem will include a ProductVariant connection, simplifying product detail access for order management apps without SKU comparison.

As of GraphQL Admin API version 2024-07, you can now set available and on hand quantities for inventory via the new inventorySetQuantities graphql mutation. At the same time, the...

As of version 2024-07, SellingPlan resources now support metafields. Use sellingPlanGroupCreate and sellingPlanGroupUpdate mutations to manage metafields on selling plan objects.

GraphQL Admin API 2024-07: Product Set mutation now runs synchronously by default; variant input limit increased. Use synchronous: false for complex inputs to avoid timeouts.

As of 2024-07, the product create and update webhook payload contains information about the media on a product.

Using media GIDs allows compatibility with GraphQL Admin API mutations such as...

The orders/edited webhook now includes committed_at timestamp, clarifying when edits are finalized. Use API version 2024-07+ to access this feature.

New APIs allow viewing/filtering of conditional metafield definitions. Use constraints, constraintSubtype, and constraintStatus for targeted metafield queries.

GraphQL Admin API 2024-07 adds return APIs: returnCreate for exchanges with fees, returnLineItemRemoveFromReturn for line removal, and returnCalculate for pre-return financials.

In the 2024-07 GraphQL Admin API, Shopify's suggestedRefund now includes exchange items and fees, affecting refund logic by considering all payable charges and outstanding amounts.

As of the 2024-07 release of the GraphQL Admin API, the location object will be gated by the read_locations scope. Attempting to [read the location...

As of GraphQL Admin API version 2024-07, you can manage combined listing using our new [CombinedListings API]...

API Version 2024-07 adds CartLineTarget to Product Discount Function API, enabling discounts on specific cart lines, similar to Shopify Scripts, for upsells and custom products.

In version 2024-07, Return.returnLineItems changes to an interface type. Update queries with inline fragments to ensure compatibility and handle diverse return item types.

GraphQL Storefront API 2024-07 adds requiresComponents, components, and groupedBy fields to ProductVariant for querying bundle details, enhancing product bundling capabilities.

GraphQL Admin API 2024-07 adds fixed bundle creation with new mutations: productBundleCreate and productBundleUpdate, enhancing product merchandising capabilities.

Cart#deliveryGroups now supports withCarrierRates to fetch carrier rates, requiring @defer to prevent blocking. Test this feature and share feedback.

As of version 2024-07 of the Admin GraphQL API, we're adding 14 new LocalizationExtensionsKey values to support the collection of tax / shipping credentials in several new countries.

Learn...

Country and Province REST API endpoints deprecated in 2024-07. Use Storefront API for countries. No province replacements. Update apps accordingly. Contact support for help.

The 2024-07 GraphQL Admin API checks inventory during billing. If items are out of stock, billing fails with an INSUFFICIENT_INVENTORY error, preventing overselling.

API update: Payouts GraphQL now supports query arguments for sorting/filtering. Added attributes to ShopifyPaymentsBalanceTransaction for detailed transaction insights.

As of GraphQL Admin API version 2024-07 you can query the following fields on the ShopifyPaymentsBalanceTransaction object:

• description
• amount
• fee
• source_type
• type -...

As of API version 2024-07, you can use the webhookSubscriptionsCount field to return a count of webhook subscriptions. This field returns a [Count object...

API v2024-07 adds customer_account_settings/update webhook for tracking changes in customer account settings, impacting login requirements and visibility on storefronts.

Version 2024-07 adds a moto Boolean to the payment session HTTP Post request, indicating merchant-entered credit card info. Adjust your app to handle this new field.

As of 2024-07, use validationResultSummary in mailingAddress to check shipping address validation status with results: ERROR, WARNING, NO_ISSUES, or null.

Version 2024-07 of the Admin API introduces checkoutBrandingUpsert mutation, allowing customization of divider visibility, style, and width in checkout sections.

The 2024-07 admin GraphQL update moves assignedFulfillmentOrders to QueryRoot, deprecating the Shop query, aligning with API direction for better domain primitive access.

Version 2024-07 adds fields to DeliveryCarrierService, a carrierServices query, and mutations for creating, updating, and deleting carrier services in the Admin GraphQL API.

As of version 2024-07 of the Admin GraphQL API, you can use the new trackingSupport field in FulfillmentService to check whether the fulfillment service implements the...

As of version 2024-07 of the Admin GraphQL API, you can use the new createdAt field in FulfillmentEvent to check the date and time when the fulfillment event was created.

Learn more about...

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

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.