Developer changelog

As of Admin GraphQL API 2024-07, InventoryItemInput unifies input types for inventory updates, adding fields like sku and countryCodeOfOrigin for streamlined data handling.

GraphQL Admin API v2024-07: DraftOrderInput now supports discountCodes and acceptAutomaticDiscounts. New DraftOrderPlatformDiscount type details platform discount allocations.

In version 2024-07, the GraphQL Admin API allows querying cash transactions linked to Shopify POS cash tracking sessions via the new cashTransactions connection.

read_validations scope is now needed for validation queries; write_validations for validationCreate, validationUpdate, validationDelete mutations. Update extensions accordingly.

As of April 2024, count fields are standalone with consistent naming and return a Count object. They support filtering and simplify argument effects. Migration updates field names.

As of version 2024-04 of the Admin GraphQL API, you can use the productOptionsCreate, productCreate, and productOptionUpdate mutations to create metafield-linked product options.

...

New GraphQL APIs support up to 2000 product variants, manage options, and use productSet for full product state updates. Deprecated: ProductInput and REST /products, /variants.

The 2024-04 API release introduces new GraphQL product APIs, deprecating variants and options management in ProductInput and /products and /variants REST endpoints. Migrate by Feb 1, 2025.

As of 2024-04, you can use priceWithCurrency to provide the price of the shipping rate along with the currency, whereas price uses the shop currency. If priceWithCurrency is provided,...

The Checkout API will be deprecated by April 2024. Migrate to the Storefront Cart API or Checkout Sheet Kit by April 2025 to ensure continued functionality and access to new features.

The OrderTransaction.receipt field will be removed in April 2024. Use receiptJson for JSON-formatted data to simplify integrations and API usage.

As of GraphQL Admin API version 2024-04, the following Customer sort keys have been deprecated: LAST_ORDER_DATE, ORDERS_COUNT, TOTAL_SPENT. Ordering customers by these attributes is...

As of 2024-04, you can use the metafieldsDelete mutation to delete up to 25 metafields at once.

Learn more about metafields on...

Admin API 2024-04 removes certain inventory fields and mutations. Replace them with new fields and mutations for handling quantities. Deprecated fields work until 2024-04 support ends.

As of 2024-04 version Admin GraphQL API, you can update inventory_management boolean value on the FulfillmentService object using the [fulfillmentServiceUpdate...

Admin v2024-04: Duplicate fulfillment_order_id entries in line_items_by_fulfillment_order are disallowed. Combine payloads with the same ID for REST and GraphQL fulfillment creation.

The fulfillmentOrdersOptIn field is deprecated. In API 2024-04, it defaults to true and will be removed in 2024-07. Stop using it for new fulfillment services.

As of 2024-04, we're removing the deprecated productDuplicateAsync mutation. The mutation was deprecated since 2023-07 version.

Use the...

API version 2024-04 adds FULFILLMENT_UNSUBMITTED filter to assignment_status, allowing retrieval of unrequested fulfillment orders for app-owned locations.

As of 2024-04, new error codes added to SubscriptionBillingAttemptErrorCode. Key mappings updated for Braintree, Paypal, and Stripe, impacting error handling and classification.

Shopify's 2024-04 API introduces a public product taxonomy, replacing deprecated APIs. Developers can now access standardized categories, attributes, and values via queryRoot.taxonomy.categories.

The 2024-04 API update removes deprecated marketing tactics and introduces the is_external attribute to identify externally managed activities, impacting marketing API integrations.

As of API version 2024-07, the variant image field in the product_feed/incremental_sync and product_feed/full_sync webhooks will no longer fall back to the product's first image when an image...

As of version 2024-04 of the GraphQL Admin API, a new optional field title has been added to validationCreate...

As of version 2024-04 in the GraphQL Admin API, new fields createdAt, updatedAt, and isFulfillmentService have been added to the Location object.

Learn more about Location fields on...

Apps must meet Level 2 Protected Customer Data Requirements to access order.statusPageUrl on all Admin APIs. This may be a breaking change to enhance customer data protection.

Version 2024-04 adds GraphQL Admin API support for querying Shopify POS cash tracking sessions, providing data on transactions, staff actions, and discrepancies for POS Pro users.

As of Admin GraphQL API version 2024-04, the isGiftCard field that was present on DraftOrderLineItem and CalculatedDraftOrderLineItem is now also present on:

• ExchangeCheckoutLineItem ...

In Admin GraphQL API v2024-04, subscriptionContract mutations return CUSTOMER_REDACTED error for redacted customers, impacting subscription contract creation.

Returns now create Sales entries. New enums: ReturnAgreement, RETURN, FEE (RestockingFee, ReturnShippingFee). Admin API must accept new enums. New "returns/update" webhook added. INVALID_STATE error for canceled orders.

Admin GraphQL API 2024-04 adds InventoryItemMeasurement for weight and deprecates several ProductVariant fields, streamlining inventory and product data management.

As of 2024-04, filter Product.media by media_type like IMAGE. Migrate from Product.images to access all media types, enhancing app functionality and flexibility.

GraphQL Admin API 2024-04 lets you add, remove, or update shipping lines in orders. Use isRemoved to check removals. REST and webhooks now include is_removed for tracking changes.

As of 2024-04, you can now query the OrderPaymentStatus object to obtain information about its corresponding...

As of 2024-04, you can specify custom amounts to be charged from a vaulted card through the...

As of version 2024-04 of the Admin GraphQL API, you can now void a transaction through the transactionVoid mutation. ...

The 2024-04 GraphQL Admin API adds withCodeDiscounts to order.lineItem.discountedTotalSet, allowing inclusion of code-based discounts. Default is false, no client changes needed.

Product duplication now includes variant metafields. Previously, variant metafields were ignored when products were duplicated. Products can be duplicated via...

Order risk REST and GraphQL APIs deprecated April 2024. Use new Risk Assessments API with orderRiskAssessmentCreate mutation and ORDERS_RISK_ASSESSMENT_CHANGED webhook.

As of version 2024-04 of the Admin GraphQL API, you can read the additionalInformation object value on the deliveryMethod object using the [fulfillmentOrder...

As of the 2024-01 version of the Admin GraphQL API, you can filter the prices connection on [Price...