Next Generation Events now available in developer preview
Next Generation Events are now in developer preview, adding field-level trigger control, custom GraphQL payloads, and query-based delivery filters to webhooks.
July 2026
Surface- Admin GraphQL API
productId,title,variantSku, andvariantTitlefields added toExchangeLineItem - Admin GraphQL APIOrderDisplayFulfillmentStatus now returns FULFILLMENT_NOT_REQUIRED for orders with no items to fulfill
- Action requiredAdmin GraphQL APIMarket-driven shipping now available in feature preview
- Admin GraphQL APIDraft order deposit fields are now available in the GraphQL Admin API and Customer Account API
- Action requiredAdmin GraphQL APIDeprecation of cumulative marketing engagements
- Admin GraphQL API
lineItemfield added to theGiftCardobject - Admin GraphQL API
BusinessEntitynow exposeslegalEntityIdin the GraphQL Admin API - Action requiredAdmin GraphQL APIMerchant-owned delivery profile APIs are deprecated for market-driven shipping
- Admin GraphQL APIMarket-driven shipping Admin API
June 2026
Surface- Admin ExtensionsConfigure order attribution for sales channel apps
- Admin GraphQL APIPayment mandates now expose an id field
- Breaking changesAdmin GraphQL APICarrier services will no longer be automatically added to the default shipping profile
- Breaking changesAdmin GraphQL API
DraftOrderDiscountNotAppliedWarning.priceRuleremoved in GraphQL Admin API 2026-10 - Breaking changesAdmin GraphQL APIRemoval of ITEM_NOT_STOCKED_AT_LOCATION error
- Admin GraphQL APIAdmin GraphQL API now supports app-owned delivery profiles that cover all shippable items
- Admin GraphQL APIDefine and set metafields on inventory transfers in the GraphQL Admin API
- Admin GraphQL APIPurchase-type filtering now enforced for app discounts
- Admin GraphQL APICreate channel markets with the GraphQL Admin API
- Action requiredAdmin GraphQL APIWhatsApp marketing consent now available in the Admin API and Customer Account API
- Admin GraphQL APIBulk queries now execute up to 4X faster
- Admin GraphQL APIBuy Shipping Labels with the GraphQL Admin API
- Action requiredAdmin GraphQL APINew Collection model and APIs now available
- Admin GraphQL APIStreamlined Metaobject API
- Admin GraphQL API
GiftCardCashOutTransactionis now resolvable fromGiftCardTransaction - Admin GraphQL APILocal currency support gift cards now available in the GraphQL Admin API
- Admin GraphQL APIInventory transfer webhooks include origin and destination location IDs, and mutation documentation clarified
May 2026
Surface- Breaking changesAdmin GraphQL APIExpiring offline access tokens required for all public apps as of January 1, 2027
- DeprecatedAdmin GraphQL APIRemoving deprecated PRIVATE and PUBLIC_READ enums on metaobject definitions
- Admin GraphQL API
shippingLinefield added toFulfillmentOrderLineItem - Admin GraphQL APINew
checkoutTokenfield added to theOrderobject - Admin GraphQL APICheckout And Accounts Configuration API for unified branding across checkout, customer accounts, and sign-in
- Admin GraphQL APINew
cartTokenfield added to theOrderobject - Admin GraphQL APITarget discounts to specific markets
- Admin GraphQL APIPublish and unpublish product variants independently from product
- Action requiredAdmin ExtensionsShip and pickup in one order now available in feature preview
- Admin GraphQL APIAdd actor field to subscription contract and billing attempt mutations
- Admin GraphQL APIDefault value of
appliesOnSubscriptionchanged totruefor app discount inputs
April 2026
Surface- Admin GraphQL APIMultiple product discounts can apply on a single cart line
- Admin GraphQL APIAnalytics metric targets now available in the GraphQL Admin API
- Admin GraphQL API
LineItem.priceAfterAllDiscountsBeforeTaxesSetfield now available - Breaking changesAdmin GraphQL API
totalUnsettledSetcalculation fixed for pending captures - Admin GraphQL APICustomer tax settings now available in Admin API
- Admin GraphQL APIAdd
includeInactiveargument toinventoryLevelsandinventoryLevelfields - Admin GraphQL APIAdd
isActivefield toInventoryLevel - Breaking changesAdmin GraphQL API
inventoryActivatenow preservesavailablequantity - Admin GraphQL APIAdded MOST_RELEVANT value for
CollectionSortOrder - Admin GraphQL API
LineItem.weightfield now available in public Admin API - Admin GraphQL APINew retail cash management capabilities
- Admin GraphQL APIAdd Tags to Discounts
- Admin GraphQL API
expiresInfield added toDelegateAccessTokentype - Admin GraphQL APIAdding access field to StandardMetaobjectDefinitionTemplate
- Admin GraphQL APIApp-owned metaobjects can be used without access scopes
- Admin GraphQL APIMetafield translations now available via GraphQL Admin API
- Admin GraphQL APITax summary webhook now includes merchant business entity information
- Admin GraphQL APITax Partner apps can now receive cart line properties in tax calculation requests
- Admin GraphQL APIImproved user errors on the
fulfillmentOrderCancelmutation - Admin GraphQL APITax summary webhook and calculation requests now include customer and company metafields
- Admin GraphQL APIMulti-channel support for sales channel apps
- Breaking changesAdmin GraphQL APIPayment method identifier now required for customerPaymentMethodRemoteCreate
- Admin GraphQL APICreate unpaid orders from subscription billing attempts
- Admin GraphQL APIIdentifier support added to the productUpdate mutation
- Admin GraphQL APIReport Fulfillment Order progress with new fulfillmentOrderReportProgress GraphQL mutation
- Admin GraphQL APICreate subscriptions contracts without payment methods
- Admin GraphQL APIImproved user errors on the
fulfillmentOrderMovemutation
March 2026
Surface- Action requiredAdmin GraphQL APIRemoving
visible_to_storefront_apifield on metaobject field definitions - Admin GraphQL APIAdding barcode support to inventory shipments API
- Action requiredAdmin GraphQL APIExpiring offline access tokens required for new public apps as of April 1, 2026
- Admin GraphQL API
inventoryTransferDeleteaddsINVALID_STATEerror code for transfers with in-progress product import - Admin GraphQL APIMaking
fieldDefinitionsoptional inmetaobjectDefinitionCreate - Admin GraphQL APIAdding
createdAtandupdatedAtfields toMetaobjectDefinitionobjects - Action requiredAdmin GraphQL APINew payment decline codes added to
OrderTransactionErrorCodeenum - Action requiredAdmin GraphQL APIShopifyQL returns fields deprecated and replaced with sales reversals fields
- Breaking changesAdmin GraphQL API
inventorySetScheduledChangesmutation is being removed with no replacement - Admin GraphQL APINew analyticsQueryable capability for Metafield Definitions
February 2026
Surface- Breaking changesAdmin GraphQL APINew APIs to read and write shipping options in delivery profile
- Admin GraphQL APISubscriptions APIs: Introduce SubscriptionBillingAttemptState
- Breaking changesAdmin GraphQL APIJSON metafield values limited to 128KB
- Admin GraphQL APIRemaining line items weight available for fulfillment orders
- Admin GraphQL APIAdded new enum values for ColumnDataType in ShopifyqlTableDataColumn
- Admin GraphQL APIWebhook subscriptions now support a name field for identification
- Admin GraphQL APIThe
GiftCardConfigurationobject now includes default gift card expiration - Admin GraphQL APISubscriptions APIs: new payment error code and error classification
- Admin GraphQL APIAutomatically copy cart metafields to orders at checkout completion
- Admin GraphQL APIIntroducing the
tracks_inventoryquery filter for products
January 2026
Surface- Admin GraphQL APIDiscouraging use of
receiptJsononOrderTransactionin the GraphQL Admin API - DeprecatedAdmin GraphQL APIEvents data now limited to one year retention
- DeprecatedAdmin GraphQL APIDeprecated
deliveryShippingOriginAssignmutation - Admin GraphQL APIAccess transactions on the Return object
- Admin GraphQL APINew Return Reason Definitions API for Better Return Insights
- Admin GraphQL API
INVALID_BILLING_ADDRESS: new processing error for subscription billing attempts - Admin GraphQL APISubscription billing attempts throttling
- Admin GraphQL APIIntroducing the
orders/link_requestedwebhook topic - Customer Account APIMetafield references added to Customer Account API
- Admin GraphQL APIDue on Fulfillment payment term available for pre-orders
December 2025
Surface- Action requiredAdmin GraphQL APIDeprecation of
Shop.billingAddressin favor ofShop.shopAddress - Breaking changesAdmin GraphQL APIRemoving
permitsSkuSharingfield from fulfillment service - Admin GraphQL APIConversion tracking fields added to MarketingEngagementCreate
- Breaking changesAdmin GraphQL APICustomer marketing URL fields now require write access
- Admin GraphQL APISet and retrieve
processedAtin therefundCreatemutation - Admin GraphQL APIFaster bulk operations
- DeprecatedAdmin GraphQL APIDeprecation of
OrderTransaction.authorizationCodein favor ofOrderTransaction.paymentId - Breaking changesAdmin GraphQL APINew compare and swap syntax for the
inventorySetQuantitiesmutation - Action requiredAdmin GraphQL APIConcurrency protection features for inventory and refund mutations
- Breaking changesAdmin GraphQL APIMaking
changeFromQuantityfield required (with explicit opt-out) - Breaking changesAdmin GraphQL APIMaking idempotency mandatory for inventory adjustments and refund mutations
- Admin GraphQL APIAdding idempotency for inventory adjustments and refund mutations
- Admin GraphQL APINew
changeFromQuantityfield to manage inventory - DeprecatedAdmin GraphQL APIImproved compare and swap inventory updates for the
inventorySetQuantitiesmutation - Admin GraphQL APINew fields to combine bundle options
- Admin GraphQL APIOffline access tokens now support expiry and refresh
- Admin GraphQL APIAdvanced Metafield & Metaobject Querying
- Admin GraphQL APIOrder editing new validations and handled
userErrors - DeprecatedAdmin GraphQL APIInventoryItem.variant field deprecated in favor of InventoryItem.variants connection
November 2025
Surface- Admin GraphQL APITax summary webhook and calculation requests now includes shop and presentment currency amount
- Breaking changesEvents & webhooksTax summary webhook
created_atfield now returns UTC timezone - Breaking changesAdmin GraphQL APITax webhook summary and calculation requests now use Global IDs
- Admin GraphQL APItax_summaries/create webhook and taxSummaryCreate mutation now available
- Admin GraphQL APICarrier Service API now includes order totals and customer tags
- Admin GraphQL APIOrder Update Phone Field Public
October 2025
Surface- Admin GraphQL APINew Queries for Bulk Operations
- Breaking changesAdmin GraphQL APIBulk operations group objects default changed to
false - Admin GraphQL APIOptional location inputs for inventory transfers
- Admin GraphQL APINew ACH support for deferred payments
- PlatformIncreased limits in metafield and metaobject definitions
- Admin GraphQL APINew
notifyparameter available on thestoreCreditAccountCreditmutation - Admin GraphQL APINew: Unlisted Product Status
- Admin GraphQL APIFulfillment service callback url is now optional
- DeprecatedAdmin GraphQL APIDeprecate delivery legacy modes fields
- Admin GraphQL APINew: Support for USDC Credit field in Shopify Payments Payout GraphQL
- Admin GraphQL APIRerouting Fulfillment Orders is now possible via API
- Breaking changesAdmin GraphQL APISubscription contract shipping requirements now sync with product variants
- Admin GraphQL API
multipassIdentifierfield added to GraphQL Admin API - Admin GraphQL APINew
productNetworkfield on theOrderobject - Admin GraphQL APIDynamic complexity for
productVariantsBulkCreateandproductVariantsBulkUpdatemutations - Admin GraphQL API
productVariantsBulkCreateandproductVariantsBulkUpdatemutations now validateinventoryQuantitieslimits - Admin GraphQL APIDynamic complexity cost for
productCreateandproductUpdatemutations - Admin GraphQL API
productSetmutation now validatesinventoryQuantitieslimits - Admin GraphQL APIDynamic complexity cost for
productSetmutation - Admin GraphQL APIShopifyQL now available as
shopifyqlQuerywithin the GraphQL Admin API
October 2025
Surface- Admin GraphQL APIDuplicate themes with the Admin GraphQL API
- Action requiredAdmin GraphQL APIUpcoming Markets pricing support for Draft Order checkouts
- Breaking changesAdmin GraphQL APIRemoval of deprecated
Shop.draftOrdersconnection in the GraphQL Admin API - Admin GraphQL APINew metafield definition types in GraphQL - article_reference / list.article_reference
- Admin GraphQL APIAdded support for dispute preventions
- Admin GraphQL APINew balance and due status fields for PaymentSchedule
- Admin GraphQL APINew
mandateconnection added toCustomerPaymentMethodobject - Admin GraphQL APIOrder metafield definitions and values can now be used as filters in the Shopify Admin UI
- Admin GraphQL APIEnhanced API stability with rate limiting for remote payment method creation
- Admin GraphQL APIStore credit now supports company locations as account owners in Admin and Customer APIs
- Admin GraphQL APIFacebook (Meta) orders support native exchanges
- Admin GraphQL APINew enum values for FulfillmentEventStatus
- Admin GraphQL APIMetaobject field definitions offer new capabilities
- Breaking changesAdmin GraphQL APISetting
permitsSkuSharingargument tofalsewhen creating a fulfillment service returns an error - Admin GraphQL APIGlobal HS code is now supported in GraphQL Admin API
- Breaking changesAdmin GraphQL APICollectionReorderProducts operation userErrors now includes code field
August 2025
Surface- Admin GraphQL APINew PRESERVE_STANDALONE_VARIANT strategy for the productVariantsBulkCreate mutation
- Action requiredAdmin GraphQL APIIntroducing the new
contextfield to specify discount eligibility - Admin GraphQL APIOrder Editing API supports discounts on fulfilled line items
- Admin GraphQL API
webhookSubscriptionCreateandwebhookSubscriptionUpdatesupport all URI types - Admin GraphQL APINew guidelines for
referenceDocumentUriin inventory adjustments - PlatformRemoval of support for the "Sell from all locations" fulfillable inventory setting
- Admin GraphQL APIShopify Payments Payout GraphQL type supports
external_trace_id - Admin GraphQL APIOrders query now supports
current_total_priceandtotal_weightfilters andCURRENT_TOTAL_PRICEas asortKey
July 2025
Surface- Action requiredAdmin GraphQL APIDeprecation of the
ProductVariant.taxCodefield - Admin GraphQL APINew fields for inventory shipment timestamps
- Admin GraphQL APIAdd option to filter by dispute type in OrderListQuery GraphQL query
- DeprecatedAdmin GraphQL APIOrder cancellation now supports refunds to store credit
- Admin GraphQL APINew warning
DraftOrderMarketRegionCountryCodeNotSupportedWarningadded toDraftOrder - Admin GraphQL APIAdd created/updated at time based filters for an order's fulfillments
- Action requiredAdmin GraphQL APINew field for discount classes on
DraftOrderPlatformDiscount - Admin GraphQL APINew range fields available for segment filters in GraphQL Admin API
- Admin GraphQL APINew AppUninstall mutation to allow apps to uninstall themselves.
- Admin GraphQL APIRemove unprocessed exchange lines from a return
- Admin GraphQL APINew GraphQL fields for return management
- Breaking changesAdmin GraphQL APIReturns Processing APIs replaces Return Refund APIs
June 2025
Surface- Admin GraphQL APIIncrease draft order line item limit from
250to499 - Breaking changesAdmin GraphQL APIRemoved tax-related fields from the
ShopFeaturesobject - Admin GraphQL APINew
estimatedShippedAtargument added to FulfillmentOrderAcceptFulfillmentRequest mutation - Admin GraphQL APIImage alt text can now be translated
- Action requiredAdmin GraphQL APIDeprecation of POST requests without a Content-Length or Transfer-Encoding: chunked header
- Admin GraphQL APIOptional
groupObjectsargument in bulk operations mutations that offers faster and more reliable job execution - Admin GraphQL APIShop metafield definitions are now available in the Shopify Admin and Admin API
- Admin GraphQL APIOrder editing workflows now offer direct session access via mutation arguments and return fields
- Breaking changesAdmin GraphQL API
productCreatesurfaces input errors asuserErrors - Admin GraphQL APINew fields for OrderTransaction and OrderCreateManualPayment
- Admin GraphQL APINew
FREE_GIFT_CARD_NOT_ALLOWEDerror code for subscription billing attempts - Admin GraphQL APIGenerally available: Standard product review syndication program
- Admin GraphQL API
AMAZON_PAYandFACEBOOK_PAYvalues enumerated in digital wallets - Breaking changesAdmin GraphQL APIContextual pricing and publishing APIs use backup region fallback
May 2025
Surface- Admin GraphQL APIAdd and remove customers from an order with GraphQL
- Admin GraphQL APIShipping Rates – Return backup rates for 3xx and 4xx carrier responses
- Breaking changesAdmin GraphQL APIDeprecation of legacy return APIs and improvements to return management
- Admin GraphQL APIFilter articles by title
- Action requiredAdmin GraphQL APIDeprecation of Product, Order, and Shipping Discount Function APIs
- Breaking changesAdmin GraphQL APIUncapped counts in GraphQL
- Admin GraphQL APIEdit line items with subscriptions and preorders prior to fulfilling an order
- App storeApps now permitted to issue refunds to store credit
- Admin GraphQL APIRefund to Store Credit
- Admin GraphQL APINew GraphQL API for Draft Order Delivery Options for Developers
- Action requiredAdmin GraphQL APIPublic access for app owned metafields and metaobjects is now disabled
- Action requiredAdmin GraphQL APIDeprecating
gatestypes and fields across the GraphQL Admin, Storefront, and Functions APIs - Breaking changesAdmin GraphQL APIThe
UnitPriceMeasurementMeasuredUnitenum now includes imperial units and counts - Admin GraphQL APIShop Component: Shop Pay Payment Request Receipt queries
- DeprecatedAdmin GraphQL APIDeprecation of
draftOrderCreateMerchantCheckoutmutation
April 2025
Surface- Action requiredAdmin GraphQL APICash transaction rounding for Point of Sale purchases in selected countries
- Action requiredAdmin GraphQL APINew arguments added to
statusPageUrlfield on theOrderobject - Breaking changesAdmin GraphQL APIChange in
productSetmutation error code for suspended product - Admin GraphQL APIAdding
publicDisplayNamefield onShopPlan - Admin GraphQL APICreate smart collections automatically with PRODUCT_CATEGORY_ID_WITH_DESCENDANTS
- Admin GraphQL APINew Inventory Transfers experience available for testing in Dev Preview
- Admin GraphQL APIAllocate a single line item's quantity across multiple fulfillment locations
- Admin GraphQL APINew
planHandlefield for managed pricing app subscription plans - Admin GraphQL APIStable GraphQL API versions to backfill enum values
- Admin GraphQL API
draftOrderCountavailable in 2025-07 - Admin GraphQL API
productSetandcustomerSetmutations now support upserts and custom IDs - Admin GraphQL APIAdding defaultEmailAddress field to Customer
- Admin GraphQL APICustomer RFM group now available in GraphQL Admin API
- Admin GraphQL APINew finance KYC information field available for Shopify-approved finance apps
- Admin GraphQL APINew enum values for
FulfillmentOrderRejectionReason - Admin GraphQL APINew theme file metadata fields added to
OnlineStoreThemeFileOperationResultobject - Admin GraphQL APIExpanded control of privacy settings using the GraphQL Admin API
- Admin GraphQL APINew enum values for
CustomerPaymentMethodRevocationReason - Admin GraphQL APINew fees and net fields for balance transactions
- Admin GraphQL APICombined Listings Update Mutation Enhancements
- Admin GraphQL APIView gift card maximum values
- Admin GraphQL APINew
articleAuthorsquery in the GraphQL Admin API - Admin GraphQL APINew filter options added to
pages,articles, andcommentsqueries
March 2025
Surface- Admin GraphQL APIInventoryItem Webhooks Accessible with Product Scopes
- Admin GraphQL APILocation ID Queryable with Inventory Scopes
- Admin GraphQL APINew additions to delivery promise participants APIs
- Admin GraphQL APIRe-enabled customer search terms in the GraphQL and REST Admin APIs
- Admin GraphQL APIDraft Orders automatically purged after 1 year of inactivity
- Admin GraphQL APIRetail Exchanges now use the Shopify Exchanges implementation
- Breaking changesAdmin GraphQL APIFeeSale fee field is nullable as of 2025-07
- Admin GraphQL APINew
include_mirrored_exchangesquery filter parameter - Breaking changesAdmin GraphQL APIDeprecating PriceListUserErrorCode values
- Admin GraphQL APIAdding defaultPhoneNumber field to Customer
- Admin GraphQL APINew GraphQL APIs for Inventory Transfers Management
February 2025
Surface- Breaking changesAdmin GraphQL APIMetafield description input field removal
- Admin GraphQL APINew customer address capabilities in the Admin API
- Admin GraphQL APIThe
X-Shopify-API-Deprecated-ReasonHTTP header will return actual GraphQL deprecations if any - Admin GraphQL APIReserved prefix protection for metafields and metaobjects
- Admin GraphQL APINo-op for unchanged metafields and metaobjects
- Admin GraphQL APINew ends_at, created_at, and updated_at query filter parameters for searching discounts
- Admin GraphQL API
NON_TEST_ORDER_LIMIT_REACHEDerror code for subscriptions billing attempts - Breaking changesAdmin GraphQL APIUpdated Country Harmonized System Code validations on Product Variant mutations
- Admin GraphQL APIDiscounts reference docs improvements
- Admin GraphQL APIAttribute Marketing Consent to Retail Locations
- Breaking changesAdmin GraphQL APIRemoving unnecessary
RELEVANCEsort options
January 2025
Surface- Admin GraphQL APIRecord partial payments on Orders
- Breaking changesAdmin GraphQL APINew Catalog APIs
- DeprecatedAdmin GraphQL APIPayout statuses In Transit and Scheduled have been merged
- Admin GraphQL APINew creation, update, and status filters for subscriptionContracts
- Admin GraphQL APIOptional
roleargument forthemeCreatemutation - Admin GraphQL APIInventoryItem Queryable and Updatable with Products Scopes
- Admin GraphQL APISupport added for $app in product queries by metafield
- Admin GraphQL APIExpose the id field in ProductFullSyncPayload object
- Admin GraphQL APILine item weight input for
orderCreatemutation - Admin ExtensionsNew
inventoryItemfield on ProductSetVariantInput - Admin GraphQL APINew card brands for OrderTransactions.paymentMethods
- Admin GraphQL APIAdd tax validation with localizedFields in Checkout UI Extensions & Functions
- Breaking changesAdmin GraphQL APINew Markets APIs
- Admin GraphQL APINew
collection_idfilter added toproductsquery filters - Admin GraphQL APINew fields to represent product bundles in a grouped view
- Admin GraphQL APIMinimum requirement is now optional on automatic discounts
- Admin GraphQL APINew customer input field for the OrderCreate mutation
- Admin GraphQL APIIntroduce concatenatedOriginContract to subscriptionLine
- Breaking changesAdmin GraphQL APIUnused PriceListUserErrorCode values removed
- Admin GraphQL APINew delivery promise participants API
- Admin GraphQL APIUpdate in orders webhook to view bundles and their components
- Admin GraphQL APICombined Listings update mutation error improvements
- Action requiredApp storePublic apps must use new GraphQL Product APIs to be accepted in the Shopify App Store
- Admin GraphQL APILink any product metafields of type list.metaobject to product options
- Action requiredAdmin GraphQL APIFulfillment Hold Access Update For Node Queries
- DeprecatedAdmin GraphQL APIChange to FulfillmentOrderSortKeys
- Admin GraphQL APIBXGY discount support for subscriptions
- Action requiredAdmin GraphQL APIApply multiple holds to a single fulfillment order
- Admin GraphQL APIEnhanced variant query limits for single product queries
- Admin GraphQL APIAdd new requiresShippingMethod field to fulfillmentServiceCreate and fulfillmentServiceUpdate mutations
- Admin GraphQL APIReverseFulfillmentOrder.order field is nullable as of 2025-01
- Admin GraphQL APISupport
DelayedFulfillment Status in GraphQL API - Admin GraphQL APIAdmin access input is now optional when setting metafield definition access
- Action requiredAdmin GraphQL APINew validation against duplicate handles in productCreate, productUpdate, and productSet mutation inputs
- Admin GraphQL APIIntroduce a
tax_exemptfield associated to aCompanyLocation
December 2024
Surface- Admin GraphQL APIEvents and Origins in Store Credit Account Transactions
- Breaking changesAdmin GraphQL APIDeprecated
SubscriptionMailingAddressin favor ofMailingAddress - Breaking changesAdmin GraphQL APIRemoval of deprecated shop fields
- Admin GraphQL APIImproved
productTags,productVendors,productTypes - Admin GraphQL APINew inventoryPolicy argument for billing mutations
- Admin GraphQL APINew
LocalizationExtensionKeysvalue for Mexico - Admin GraphQL APINew revocation reasons for payment methods for 2025-01
- Admin GraphQL APISearch discountNodes by exact discount code in the GraphQL Admin API
- Action requiredAdmin GraphQL APIChanges to ScriptTag displayScope field on Admin GraphQL API
- Action requiredAdmin GraphQL APIDeprecation Notice: CalculatedOrder for committed order edits
- Admin GraphQL APIUsing custom ids and handles in product and customer lookups
- Admin GraphQL APIAdding unique values to metafields
- Admin GraphQL APIApps can now manage access settings for merchant metafield definitions
- Admin GraphQL APISupport for additional Shopify Functions APIs in draft orders
- Admin GraphQL APIImproved billing attempt error handling for subscriptions in Selling Plan API
- Admin GraphQL APISet custom prices in draft orders
- Action requiredAdmin GraphQL APISimplifying how metafield and metaobject permissions work
- Admin GraphQL APICustomize line items in Checkout and Customer Accounts order summary using new Checkout Branding API settings
- Action requiredAdmin GraphQL APIPrivateMetafield is now deprecated
- Admin GraphQL APIConfigure optional scopes for Shopify apps
November 2024
Surface- PlatformIncreased limits for automatic function-based discounts
- Admin GraphQL API
manualPaymentGatewayfield added toorderTransactionobject - Action requiredAdmin GraphQL APIRemove
metafieldDeletein favor ofmetafieldsDelete - Admin GraphQL APIUpdates to Shopify’s Standard Product Taxonomy - October 2024
- Admin GraphQL APIGraphQL Over HTTP
- Action requiredAdmin GraphQL APIContent type
application/graphqlis deprecated - Action requiredAdmin GraphQL APIRemoving
multiLocationfield fromShopFeatures
October 2024
Surface- Action requiredAdmin GraphQL APIUpdate to
fulfillmentHold.heldByAppfield fromfulfillmentHold.heldByfield - Admin GraphQL APIAPI
StringConnectionincludesnodesfield - Admin GraphQL APIShopify Payments Payout Summary GraphQL surfaces advance fees and advance gross fields
- DeprecatedAdmin GraphQL API
lineItemconnection is no longer deprecated onFulfillmentOrderLineItemresource - Admin GraphQL APIUpdated CalculateExchangeLineItemInput and CalculatedExchangeLineItem Variant nullability
- Admin GraphQL APIAdd
accountOpenerNametoshopifyPaymentsAccount - Admin GraphQL APIBulk query operation userErrors now includes code field
- Admin GraphQL APIShopify Payments Balance Transaction GraphQL type supports advance and advance funding type
- Admin GraphQL APIShopify Payments GraphQL Admin API supports querying a list of disputes
- Admin GraphQL APIExposing Business Entity fields on Admin API
- Admin GraphQL APIAdded
variant_strategyforproductOptionsCreate - Admin GraphQL APIAdding
requiresComponentsfield toProductVariantsBulkInput - Admin GraphQL APINew
CollectionsCountquery in the GraphQL Admin API - Admin GraphQL APIMetafield Definition Webhooks
- Admin GraphQL APIShopifyPaymentsBankAccount GraphQL Admin API unused fields removed
- Admin GraphQL APIAdded new field
recurring_cycle_limitandapplies_on_subscriptionto DiscountAutomaticApp and DiscountAutomaticAppInput - Admin GraphQL APINew
has_variants_that_requires_componentsfield on Product Webhooks - Admin GraphQL APINew field and queries for the
StaffMemberobject in the GraphQL Admin API - Action requiredAdmin GraphQL APIRemoval fulfillment service shipping method
- Admin GraphQL APINew mutation to create an order
- Admin GraphQL APIAdmin API update on
fulfillmentOrder.destinationandFulfillmentOrderDestinationobject - Admin GraphQL APIFulfillment Constraints now support Local Pickup
- Action requiredAdmin GraphQL APIFulfillment Constraints can now be associated with one or multiple delivery methods
- Admin GraphQL APIAdmin API includes
discountNodesCount - Admin GraphQL APIIntroducing Payment Groups and Sessions to SubscriptionBillingAttempts
- Action requiredAdmin GraphQL APIExposing the order adjustments connection on a Refund
- Admin GraphQL APINotify customers when their return requests are approved or declined
- Action requiredAdmin GraphQL APIBreaking changes to returns API: Deprecate
reverseDeliveryDisposemutation - Action requiredAdmin GraphQL APIRemoval of the
priceRuleresource from GraphQL Admin API - Admin GraphQL APINew CompanyLocationStaffMemberAssignments API endpoints for managing staff member assignments on a Company Location
- Admin GraphQL APITranslatable content that is specific to a market context is now exposed
- Admin GraphQL APIAdd new theme-related fields to
TranslatableResourceTypeenum - Admin GraphQL APILocalized fulfillment hold reason on
FulfillmentHold - Action requiredAdmin GraphQL APIAdding pagination arguments to Customer addresses
- Admin GraphQL APIGraphQL support to send customer account invite
- Admin GraphQL APINew customer account pages now available in menus via Admin API
- Admin GraphQL APINew abandoned checkouts listing endpoint on the admin GraphQL API
- Admin GraphQL APIAdd subscription status updates to bulkOperationRunMutation
- Action requiredAdmin GraphQL APIQuerying events through the
eventsconnection andCommentEvent.subjectbecomes nullable - Action requiredAdmin GraphQL APIRemoval of deprecated product image mutations from the GraphQL Admin API
- Admin GraphQL APIAdded FAILED_TO_RETRIEVE_BILLING_ADDRESS to CustomerPaymentMethodRevocationReason Enum
- Action requiredAdmin GraphQL APIOrder Management apps can no longer fulfill orders that are assigned to a different fulfillment service
- Admin GraphQL APINew parameter on
fulfillmentServiceDeleteto control inventory behaviour on location removal - Admin GraphQL API
fulfillmentOrderHoldmutation updated to return a fulfillment hold resource - Action requiredAdmin GraphQL APINew field and permission update to fulfillment hold resource
October 2024
Surface- Admin GraphQL API
ProductInputsplit intoProductCreateInputandProductUpdateInputin2024-10 - Admin GraphQL APIAdmin GraphQL API: new APIs for Pages, Articles, Blogs, and Comments now available in 2024-10
- Action requiredAdmin GraphQL APIDeprecating explicit access grants for app-owned metafields
- Admin GraphQL APIIntroducing theme and theme file management in the Admin GraphQL API
- Admin GraphQL APIChanging the default value of permitsSkuSharing argument in fulfillmentServiceCreate
- Admin GraphQL APIIntroducing metafield definition capabilities in the admin API
- Action requiredAdmin GraphQL APIMetafield Definition Capability Framework and Deprecation of
use_as_collection_condition - Admin GraphQL APINew inventory input fields in productSet mutation in version 2024-10
- Action requiredAdmin GraphQL APIImprovements in the GiftCard GraphQL endpoints and introducing GiftCardTransaction types
- Action requiredAdmin GraphQL APIThe fulfillmentOrdersReleaseHolds Mutation Is Deprecated
- Admin GraphQL APIAdmin API includes
urlRedirectsCount - Admin GraphQL APINew query attributes on products query
- Admin GraphQL APIFulfillment Holds Now Able To Be Released by ID
- Admin GraphQL APIAdmin API includes
statusPageUrlfield onOrder - Admin GraphQL APICustomer SMS Consent Collected From now returns Shopify when the buyer consents to SMS marketing in Shopify Checkout
- Action requiredAdmin GraphQL APIIntroducing PRODUCT_CATEGORY_ID in CollectionRuleColumn and Deprecating PRODUCT_TAXONOMY_NODE_ID for automated collection creation
- Action requiredAdmin GraphQL APIRemoving V2 suffix from fulfillmentCreateV2 and fulfillmentTrackingInfoUpdateV2
- Admin GraphQL APIAllow item activation at legacy location
August 2024
Surface- Action requiredAdmin GraphQL APIReverseFulfillmentOrderLineItem.fulfillmentLineItem field is nullable as of 2024-10
- DeprecatedAdmin GraphQL APIAdmin API removes
lineItemsMutablefield onOrder - Admin GraphQL APICustomer, Order, Company, and Model3d GraphQL types available in MetafieldReference union for 2024-01 and onward
- Admin GraphQL APIAdding
productVariantsCountGraphQL field. - DeprecatedAdmin GraphQL APIRemove unused error codes from LocationDeactivateUserErrorCode
- DeprecatedAdmin GraphQL APIShopifyPaymentsAccount GraphQL Admin API unused fields removed
- Action requiredAdmin GraphQL APIBreaking changes to media in GraphQL API's ProductSet mutation in version 2024-10
- Action requiredAdmin GraphQL APIDeprecation Notice:
ProductChangeStatusin Admin GraphQL API - Action requiredAdmin GraphQL APIRemoving MetafieldStorefrontVisibility-related fields and mutations from Admin GraphQL API
- Admin GraphQL APIAdded new
accessargument tostandardMetafieldDefinitionEnableandstandardMetafieldDefinitionsEnableGraphQL mutations - Action requiredAdmin GraphQL APIFulfillment Hold Release Access Update
- Admin GraphQL APIProduct category included in product webhooks
July 2024
Surface- Admin GraphQL APIRefunding orders with multiple shipping lines returns accurate data
- Action requiredAdmin GraphQL APIBreaking changes in several ProductVariant related mutations in version 2024-10
- Action requiredAdmin GraphQL APIBreaking changes to GraphQL product duplicate APIs in version 2024-10
- Action requiredAdmin GraphQL APIAdded
synchronousParameter toproductDeleteMutation and IntroducedProductDeleteOperationObject for Asynchronous Deletion Tracking