Developer changelog

Starting 28th Oct 2024, hCaptcha is required for login, account creation, and password reset forms. reCAPTCHA is deprecated; update custom code to avoid 400 errors.

In API version 2025-01, heldBy is replaced by heldByApp in fulfillmentHold. Update queries to fulfillmentHold.heldByApp.title for full app details.

Full-page extensions can't coexist with others in the same extension, enhancing performance. Use editor extension collections for compatibility. Affects new or updated extensions only.

Grace period for criteria like store speed and app rating extended to 60 days. Fulfillment and Carrier services criteria will also have a 60-day grace period upon enforcement.

As of version 2025-01 of the GraphQL Storefront API, Cart now supports removing Gift Cards by Id.

After a cart has been created and a Gift Card applied - perform the...

Starting October 15th, 2025, all Shopify App Store apps that appear in the Shopify admin must use the latest Shopify App Bridge by...

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 2024-10 now supports querying all disputes for a shop as a GraphQL connection, enhancing data retrieval 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.

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.

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.

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

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

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.

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

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

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

The...

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

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