Developer changelog

Admin GraphQL API 2024-10 introduces QueryRoot.discountNodesCount to fetch total shop discounts, enhancing data retrieval for developers.

As of Payments Apps API version 2024-10, the StartPaymentSession payload for all payment extension types will have one new field:...

GraphQL Admin API 2024-10 adds payment_group_id and payment_session_id to SubscriptionBillingAttempt, enhancing subscription billing insights and merchant-facing statistics.

The 2024-10 Admin GraphQL API adds Refund.orderAdjustments for refund queries, deprecates OrderAdjustment.kind, and updates Refund.refundShippingLines for shipping costs.

In API version 2024-10, use notifyCustomer to email customers on return approval/decline. Add custom messages with declineNote. No email sent if Order.email is null.

API v2024-10 adds marketId for retrieving market-specific translatable content in theme templates and section groups, enhancing theme customization for specific markets.

API v2024-10 adds new fields to TranslatableResourceType for online store themes, enhancing granularity and reducing reliance on ONLINE_STORE_THEME. Also, a nestedTranslatableResources connection is added.

We've added a new localized string field displayReason to FulfillmentHold so that you can query for a human-readable reason when a fulfillment is on hold.

As of GraphQL Admin API version 2024-10, the addressesV2 field is introduced on the Customer object to support paginating through a customer's addresses.

Learn more about the Customer...

As of GraphQL Admin API version 2024-10, you can use the customerSendAccountInviteEmail mutation to send an email invite to create a classic customer account.

As of API version 2024-10, you can add links to the Orders, Profile, and Settings pages to navigation menus.

To learn more, refer to...

As of 2024-10, you can use the abandonedCheckouts endpoint to get the list of abandoned checkouts of a shop. This will replace the current...

The 2024-10 GraphQL Customer API update adds fields for querying subscription contracts and requires new permissions for access and mutations. New connections: lines and orders.

Subscription Status updates can now be run with the bulkOperationRunMutation.

The following mutations have been added:

• subscriptionContractActivate
• subscriptionContractCancel *...

As of 2024-10, query events via eventsCount, event, and events. events connection added to multiple types. CommentEvent.subject is now nullable; deletionEvents deprecated.

In API v2024-10, inventory errors move from userErrors to warnings with codes for stock issues. Use warnings to manage cart items or inform buyers of changes.

Webhook API 2024-10 adds app/scopes_update topic, notifying apps of changes in granted access scopes, aiding in tracking installation permissions.

Admin API v2024-10 adds created_fulfillment_hold to fulfillment_orders/placed_on_hold webhook, ensuring visibility of created holds even if released or deleted.

As of 2024-10, deprecated image mutations are removed from the GraphQL API. Use productCreateMedia, productDeleteMedia, productUpdateMedia, and productReorderMedia instead.

As of GraphQL Admin API version 2024-10, the CustomerPaymentMethodRevocationReason object has a new enum value: FAILED_TO_RETRIEVE_BILLING_ADDRESS. This value is assigned when a customer payment...

Starting October 2024, order management apps can't create fulfillments for third-party locations. Fulfillment service apps can fulfill orders if they have the correct access scopes.

GraphQL API v2024-10 adds inventoryAction enum to fulfillmentServiceDelete mutation, allowing KEEP, DELETE, or TRANSFER inventory actions, impacting inventory management.

As of the GraphQL Admin API version 2024-10, the fulfillmentOrderHold mutation will return the fulfillment hold that was created in a new fulfillmentHold return field.

Learn more about the...

GraphQL Admin API 2024-10 adds heldByRequestingApp to FulfillmentHold. heldBy now requires read_apps scope. Use heldByRequestingApp to check app-created holds.

In the 2024-10 Admin GraphQL API, ProductInput is split into ProductCreateInput and ProductUpdateInput. productCreate and productUpdate now use a new product argument.

Version 2024-10 of the Admin GraphQL API allows reading/modifying Pages, Articles, Blogs, and Comments with new types and queries, enhancing content management for developers.

App Store ads on the Shopify App Store now support targeting tag-level category pages, in addition to main and sub-category pages. For more information on App Store category page types, [see...

Specifying grants for specific apps on app-owned metafields is now deprecated. New apps will not be able...

New resource logs each subscription billing attempt, using idempotency keys to prevent duplicate orders. Successful attempts create orders, no impact on existing partners.

New "SubscriptionBillingAttempt" resource logs billing attempts with idempotency keys to avoid duplicates, creating orders on success. No impact on existing partners.

Added API resource for local payment methods payment details, enhancing transaction data access for developers.

API v2024-10 introduces admin API for Online Store Themes, matching REST API features. New queries and mutations enhance theme and file management, boosting efficiency for developers.

As of 2025-01, the default value for the permitsSkuSharing argument in the fulfillmentServiceCreate mutation has been updated to true.

Please be aware that this argument is deprecated and...

API version 2024-10 introduces metafield definition management via Admin API, allowing developers to enable, disable, and query metafield capabilities for enhanced Shopify integration.

API v2024-10 introduces the Metafield Definition Capability Framework, replacing use_as_collection_condition with smart_collection_condition for better flexibility and extensibility.

GraphQL API v2024-10 introduces ProductSetInventoryInput for setting available or on_hand quantities in ProductSet and ProductSetVariant mutations, enhancing inventory management.

Shopify CLI update: Instant dev server startup, no Ruby dependency, unified TypeScript commands, and headless Liquid console for streamlined theme development.

Added shop_name and shop_url to theme install events for better merchant insights. Implemented Google e-commerce events for enhanced tracking and precise data analysis in Shopify Theme Store.

As of Shopify CLI 3.67 and Javy 3.1, Shopify Functions built in JavaScript can see improved performance by as much as 40% when combined with [@shopify/shopify_function...

New parameters shop_name and shop_url added for app install events in Shopify, plus Google e-commerce events for better tracking and data analysis on app listing pages.

The quantityAvailable and availableForSale fields will now reflect country-specific inventory availability, scoped to the specified market country of the Product Feed. The Fulfillable Inventory...