Developer changelog

Merchants using the Storefront API can now offer Combined Listings with Shopify. The Shopify Combined Listings app is available to merchants on Plus...

As of 2024-10, you can use the recurring_cycle_limit and applies_on_subscription field on the...

As of 2024-10, product webhooks include a boolean for variant bundles. Update your API version to receive has_variants_that_requires_components in payloads.

The 2024-10 GraphQL Admin API update adds accountType to StaffMember, introduces currentStaffMember and staffMembers queries, and deprecates Shop.staffMembers.

As of October 2024, the shippingMethods field is removed from fulfillmentService queries and mutations. Fulfillment by Amazon is unsupported; use Amazon's Multi-Channel Fulfillment instead.

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

Learn more about orderCreate on...

POS UI Extensions update: iOS debugging via Safari, new POSBlock and POSBlockRow components, deprecated ActionItem, added windowed modals. Applies to version 2024-10, app 9.19.0.

Associate Fulfillment Constraint functions with multiple delivery methods via new GraphQL mutations. New delivery_method_types field required. Existing functions remain unchanged for current methods.

Admin GraphQL API 2024-10 adds support for Fulfillment Constraint functions with Local Pickup. Use mutations to register or update functions for PICK_UP delivery.

Admin API 2024-10: fulfillmentOrder.destination now returns FulfillmentOrderDestination object, not null. New field destination.location retrieves pickup location.

As of 2024-10, we've added a CompanyLocationStaffMemberAssignment to the CompanyLocation object for viewing the staff members assigned to the company location.

You can assign and remove...

As of 2024-10, the priceRule resource is being removed. The queries and mutations have been deprecated since 2023-03.

The...

As of GraphQL Admin API version 2024-10, the reverseDeliveryDispose mutation will be deprecated. Use the...

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.

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

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

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

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

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.

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.

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

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 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 2024-10, you can use the abandonedCheckouts endpoint to get the list of abandoned checkouts of a shop. This will replace the current...

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

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.

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

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 API v2024-10 adds inventoryAction enum to fulfillmentServiceDelete mutation, allowing KEEP, DELETE, or TRANSFER inventory actions, impacting inventory management.

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.

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

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

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.

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

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.

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

Subscription Status updates can now be run with the bulkOperationRunMutation.

The following mutations have been added:

• subscriptionContractActivate
• subscriptionContractCancel *...

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

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

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

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

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.