Developer changelog

As of API version 2025-01, you can access StringConnection.nodes field shorthand to retrieve an array of strings directly instead of via edges. This connection type is now consistent with...

Deep link to editor extension collections in checkout/accounts editor on dev stores. Streamline merchant onboarding with app deep links when released to merchants.

Checkout UI extensions for purchase.checkout.reductions.render-before and render-after now render at the top of one-page mobile checkouts, enhancing visibility across all API versions.

GraphQL Admin API 2024-10 adds ADVANCE_FEES and ADVANCE_GROSS fields to ShopifyPaymentsPayoutSummary, enhancing payout detail visibility for developers.

Certain Shopify Function resource limits now scale proportionally to the number of line items in the cart. Starting at 200 line items, your Shopify Function runs will be able to use more resources...

The merchant export in Partners now provides an "Attribution" column that specifies installs that are attributable to Shopify App Store ad clicks. For more information on the Partners merchant...

As of today, you can use the lineItem on FulfillmentOrderLineItem without planning for deprecation. This applies to all API versions.

Learn more about FulfillmentOrderLineItem.lineItem on...

In Admin GraphQL API 2025-01, CalculateExchangeLineItemInput.variantId and CalculatedExchangeLineItem.variant are nullable, but variantId still requires validation.

As of GraphQL Admin API version 2025-01, the accountOpenerName field will be added to shopifyPaymentsAccount

As of version 2025-01, the userErrors field that is returned by the Admin API bulkOperationRunMutation will include an optional code field.

GraphQL Admin API 2024-10 adds ADVANCE and ADVANCE_FUNDING to ShopifyPaymentsTransactionType, enhancing transaction categorization for developers.

GraphQL Admin API v2024-10 introduces Business Entity attributes for querying. Order REST API v2024-10 and webhooks now include Business Entity identifiers.

GraphQL Admin API 2024-10 now supports querying all disputes for a shop as a GraphQL connection, enhancing data retrieval for developers.

The 2024-10 Admin GraphQL API adds variantStrategy to productOptionsCreate, offering LEAVE_AS_IS or CREATE strategies for better variant and inventory management.

As of the 2024-10 version of the GraphQL Admin API, the requiresComponents field available in ProductVariantInput has been added to ProductVariantsBulkInput.

This field allows variants to...

As of 2024-10 version, we are adding CollectionsCount query to the Admin GraphQL API.

Learn more about...

As of GraphQL Admin API Version 2024-10, you can subscribe to MetafieldDefinition changes under the webhook topics metafield_definitions/create, metafield_definitions/update, and...

Shopify's GraphQL is now the primary API, with REST marked as legacy. From April 1, 2025, all new apps must use GraphQL. Migration timelines for existing apps will be announced in 2025.

As of October 1st, 2024 we have update the Theme Store algorithm. This new ranking system will refine how themes are discovered, prioritizing factors like recency, quality, and trust signals to...

As of GraphQL Admin API version 2025-01, we're cleaning up the shopifyPaymentsBankAccount endpoint and removing several unused fields.

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.

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 2024-10, query events via eventsCount, event, and events. events connection added to multiple types. CommentEvent.subject is now nullable; deletionEvents deprecated.