Developer changelog

As of GraphQL Admin API version 2024-10, we're cleaning up the shopifyPaymentsAccount endpoint and removing several unused fields.

As of Shopify CLI 3.66, log streaming and replay for Shopify Functions is generally available.

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

GraphQL API v2024-10 introduces FileSetInput for enhanced media handling in productSet. Replaces mediaIds and mediaId with files and file fields for better file management.

When accessing metafield namespaces or metaobject types, you no longer need to hard code app--{app_id}. The $app reserved prefix is now available to use in your Liquid files.

Learn more...

Dynamic and Accelerated Checkout buttons now support Shopify Functions and Product Bundles. Note: Accelerated Checkout uses shadow DOM, affecting styling and event tracking. Changes live Sept 15.

Storefront API now requires the key param in cart queries/mutations. Missing key removes private details in queries and causes errors in mutations. Applies to all API versions.

We are deprecating productChangeStatus mutation. Use...

Theme cards on the Theme Store have been updated. Theme cards are now:

1. Visually simpler (feature tags have been removed)
2. Have a link to the listing for the Theme title
3. Have a badge...

We are extending the promotion period for new Themes. Now, new Themes will be highlighted for a longer period than before.

We've added support for the Link metafield type to the metafield_tag filter in Liquid.

Furthermore, you can now consume Link metafields using dynamic sources in inline_richtext and...

We've added error messages to the Shopify Pixel Helper so that you can more easily debug your custom pixels. The Pixel Helper will display uncaught errors that occur at the top level or in the...

GraphQL Admin API 2024-10 removes MetafieldStorefrontVisibility fields, queries, and mutations. Use MetafieldDefinition.access for enhanced flexibility and functionality.

Hydrogen v2024.7.3 enhances developer experience with .env support, performance boosts, simplified context creation, and config improvements. Includes bug fixes and new waitForHydration prop.

GraphQL Admin API 2024-10 adds access argument for granular control in metafield mutations; deprecates visibleToStorefrontApi. Update your code to use access.

Updated Partner Program Agreement and API Terms effective Aug 9, 2024. Review changes to ensure compliance and support growth while maintaining security on Shopify's platform.

Admin API 2024-10 requires apps to have specific write scopes to release fulfillment holds. Insufficient access returns errors: INVALID_ACCESS in GraphQL, 422 in REST. Update scopes accordingly.

Specify app category features for better visibility on the App Store and in comparisons, aiding merchants in finding apps that meet their needs.

The 2024-10 update adds a category field to product create/update webhooks. Use API version 2024-10+ in your App Partner Dashboard to receive this data.

Effective from July 29, 2024, a 30-day hold will be applied to your first payout. This change will only impact new partners who have not yet received their first payout. Learn more about [payout...

Specify app features for 30 new categories on your listing page to enhance merchant discoverability and comparison. Full category support expected by August 2024.

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.

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...