Developer changelog

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

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

In version 2024-07, discountedPriceSet and discountedPrice in ShippingLine now include cart discounts. Avoid subtracting discountAllocations to prevent double subtraction.

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 version 2024-07 of the Admin GraphQL API, you can use the new fulfillmentsCount field in Order to count the number of fulfillments including the cancelled fulfillments that belong to an...

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.

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

...

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

GraphQL Admin API 2024-07: Create, update, delete, and query menus with new mutations and queries, enhancing menu management capabilities 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.

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

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

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

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

As of version 2024-07 of the Admin GraphQL API, you can use the new ordersCount field to count the orders for a given shop.

Learn more about ordersCount on...

As of Admin API 2024-07, Order object will expose the following new fields:

• staffMember *...

As of GraphQL Admin API 2024-07 version, you can make use of a new mutation to delete an order.

Learn more about orderDelete on...

As of Admin GraphQL API version 2024-10, we're deprecating the ability to set the available quantity on the InventoryActivate GraphQL mutation for already active states. Moving forward, use the...

Starting July 2024, MetafieldAccessInput and MetafieldAccessUpdateInput will use MetafieldAdminAccessInput and MetafieldStorefrontAccessInput enums for access control.

API now returns tax lines for tax-exempt orders, even with price=0. Full rollout by May 23, 2024. Ensure tax registrations are set for affected stores.

Shopify Plus merchants can now use the finalCapture parameter in orderCapture to release uncaptured funds on final authorization, enhancing customer satisfaction and reducing chargebacks.

Apps can now view the access field of metafield definitions they don't own. admin and storefront fields return more values, with new defaults for undefined grants.

As of API version 2024-07, we've added the RESERVED_NAMESPACE_ORPHANED_METAFIELDS error code to the metafieldDefinitionDelete mutation. This error code is returned if you attempt to delete a...

As of Admin API 2024-07, ShopifyQL API is deprecated. Use Admin GraphQL APIs like Orders and Web Pixels for data extraction. Adjust your integrations accordingly.

As of version 2024-07, 3D Models and External Videos will be included in the GraphQL Admin Files Query.

As of version 2024-07 of the GraphQL Admin API, we are introducing the MobilePlatformApplication resource. This new resource facilitates the development and operational integration of shared web...

As of version 2024-07 of the GraphQL Admin API, you can use the Metafield and MetafieldDefinition connections in the...

As of GraphQL Admin API version 2024-07 the location field on the Order object has been removed. Use the retailLocation field instead.

Learn more about the Order object on...

The GraphQL Admin API's DiscountEffectInput input object now includes an amount field. This change is...

As of GraphQL Admin API version 2024-07, you can use the new retailLocation field on the Order object to query the physical location where a retail order is created or completed.

Learn...