Developer changelog

As of API version 2023-10, url field is available on the GraphQL MediaImage's originalSource field...

The latest Admin GraphQL API update lets you check Shop Pay order protection status via shopifyProtect and listen to status changes with a new webhook, aiding fraud protection apps.

We’ve updated the app settings page with a new notification system to inform merchants of notable insights on their installed apps. Merchants will be able to quickly identify apps that are...

We’ve combined the “Fit seamlessly” and “Integrates with” fields on our app listing pages into one place. Apps that are built using the Checkout and Point of Sale extensions will have them...

As of API version 2023-07 we have added a new field called poNumber to the Order and DraftOrder object.

The OrderInput and DraftOrderInput input objects now accept a poNumber....

Sales records can now be of type AdditonalFeeSale as of 2023-07, which represents a sale associated with an additional fee charge.

For more information on this new type implementation, visit...

As of the Admin API 2023-07 Release the tax_partners/update webhook will be available.

The tax_partners/update webhook will be called whenever a tax partner is added or updated. Partners...

Product Feeds API v2023-07: Replace 'bulk' with 'full' in webhook topics; correct 'occurred_at' spelling. Use 'productFullSync' mutation for full sync notifications.

As of 2023-07, we are introducing sales type UnknownSale with line type UNKNOWN that represents new types of sales that may be added in the future and do not exist on older versions.

This...

Added taxAppConfigure mutation for tax partners to configure existing tax services, enhancing flexibility and efficiency in tax management for smoother app operations.

As of 2023-07 we're introducing a new capability to translate filters.

When enabled, all filter labels will be eligible for translations through the [Translations...

The tax_exempt field in REST Admin API 2023-07 helps determine tax exemption status for orders, excluding tax-exempt products. Key for handling tax settings in Draft Orders.

As of version 2023-07 of the Storefront GraphQL API, you can now use the StoreAvailability.quantityAvailable field to determine the inventory available for a product variant at a particular local...

As of Admin API version 2023-07, selected partners can use the new customerPaymentMethodGetDuplicationData and customerPaymentMethodCreateFromDuplicationData to migrate subscription...

Shopify Functions APIs now include sellingPlanAllocation on CartLine, title on products, inCollections for collection checks, hasTags for tags, and isAuthenticated for login status.

As of Admin API 2023-07 release we've added TOTAL_ITEM_QUANTITY to OrderSortKeys so that you can sort orders by the total quantity of items.

For more information on all of the other order...

Admin API 2023-07 deprecates productDuplicateAsync, adds productDuplicateAsyncV2 mutation and productDuplicateJob query for improved duplication performance and status tracking.

GraphQL Admin API 2023-07 adds taxExempt to Order to check tax exemption status. Excludes tax-exempt products in calculations.

New isMarketplace field in ChannelDefinition lets developers identify marketplace channels like Facebook Shops or Google Buy, enhancing order and channel management.

As of the 2023-07 release, you can use the companyContactRemoveFromCompany mutation in GraphQL to remove a company contact from a company even if they have placed orders on behalf of the...

As of GraphQL Admin API version 2023-07, the SegmentEventFilterParameter object now has the attribute acceptsMultipleValues to denote if the parameter can handle multiple values. For...

As of GraphQL Admin API version 2023-07, the CustomerSegmentMember object now has the attributes and connections to access the metafields associated to the customer.

Learn more about the...

As of 2023-07, Payments Apps API changes the decrypted message structure for payment_method.data.encrypted_message, aligning with API design standards. Update your app accordingly.

As of 2023-07, you can now create region-specific subfolders on country-code top-level domains (ccTLDs), such as shop.ca or shop.fr. Previously, subfolders could only be created on generic...

The 2023-07 API update adds discount_class to line_items in Checkout Admin REST API, distinguishing PRODUCT and ORDER discounts, aiding developers in discount management.

Admin API 2023-07 introduces Contextual Product Feeds. Partners can access contextual product data by creating feeds and subscribing to specific webhooks for updates.

As of 2023-07, you can use the new field type on TranslatableContent to get the type of the translatable content.

The new type field gives more information about the underlying...

As of API version 2023-07 , you can now specify a custom filename when using the fileCreate mutation to create files that will appear in the Admin.

To learn more about the fileCreate...

As of API version 2023-07 we have added a new field called filename to the fileUpdate mutation. This new field allows you to update the filename of both generic files and images.

To...

Unity Buy SDK deprecated as of July 1, 2023. Use Unity's HTTP APIs with Shopify's Storefront GraphQL API for commerce. Open-source GraphQL projects are also available.

As of API version 2023-07, we are no longer automatically creating a subfolder web presence for a single-country market. To maintain existing behaviour, you can follow up creating a market with the...

As of 2023-07, you can use total_count on CustomerSegmentMemberConnection endpoint, which will provide you with the total count of your specified customer segment. Also, as of...

As of API version 2023-07 new error codes FILENAME_ALREADY_EXISTS and INVALID_FILENAME will be added to the fileUpdate mutation. These error codes are returned when you attempt to...

API version 2023-07 allows partners to split and merge fulfillment orders, enhancing flexibility in managing line items across multiple or single orders.

As of the Admin API 2023-07 Release, we are providing additional webhook notifications for changes to the major entities within the B2B Customers product. These hooks are provided to enable...

The 2023-07 Admin API release introduces PUBLIC_READ access for metafield definitions, allowing merchants and apps to read, while only owners can write. Set access in reserved namespaces.

GraphQL Admin API v2023-07 adds functionParameterQueryName to segmentValueSuggestions, enabling retrieval of function parameter value suggestions for Customer Segmentation.

API v2023-07 introduces item_not_stocked_at_location error for inventory mutations, alerting when changing quantities for unstocked items at a location.

DeliveryMethod now includes a brandedPromise field for "Shop Promise" checks. MailingAddress adds a timeZone field for accurate delivery timing with maxDeliveryDateTime.

As of 2023-07 partners will be able to determine whether fulfillment has been on hold for a post-purchase with the reason ONLINE_STORE_POST_PURCHASE_CROSS_SELL.

Learn more about this new...

We've added trackingParameters on Product, Collection, Article, Post and SearchQuerySuggestion when it is a part of results coming from search and predictiveSearch as adding this to...

API v2023-07 adds stale status for inactive contracts. STALE_CONTRACT is deprecated, replaced by CONCURRENT_CONTRACT_UPDATE. New CONTRACT_STALE_STATUS error for unused contracts over 1 year.

GraphQL Storefront API now supports search and predictiveSearch for natural language queries, enhancing custom storefronts with relevant results and predictive dropdowns.

The 2023-07 Admin GraphQL API adds quantityRulesAdd and quantityRulesDelete mutations for managing B2B product variant quantity rules, enhancing control over minimums, maximums, and increments.

As of GraphQL Admin API version 2023-07, you can filter orders by their confirmation number.

The [confirmation_number...

Added PinPad, Product Search, and Device APIs. Navigator supports initialScreenName. List component updated with badge and toggleSwitch. Cart API amount field now optional.

We’ve made it easier than ever to build checkout UI extensions on the order status page! More specifically, we’ve added new getting started tutorials to help you build extensions that target all,...

We heard you love extensions. We heard you want more per app. So we shipped 10x the goodness so apps now have a limit of 50 extensions.

Developers can now customize and preview one page checkout from the checkout editor. With this new developer preview, one page checkout is automatically compatible with existing checkout extensions...

The TranslationsRegister GraphQL API now supports registering translations for URLs, enabling localized store URLs for Products, Collections, Articles, Blogs, and Pages across all API versions.