Developer changelog

Starting today, you can configure and manage your apps directly in your codebase without having to visit the Partner Dashboard. Using Shopify CLI, you can link your shopify.app.toml file to an...

Shopify CLI now packages and deploys extensions simultaneously with app-level versioning. Simplified deployment is optional until Sept 5, then mandatory. Available in CLI 3.48.

The latest GraphQL API update allows using the Admin API to manage Smart Grid layouts for POS, enabling creation, naming, and multi-location assignment with synchronized updates.

The 2023-10 Shopify Functions API update introduces Fulfillment Constraints, enabling custom fulfillment strategies by restricting shipping rates if constraints aren't met.

Storefront API now groups cart lines by discount and amount, aligning with Online Store/Ajax API. Developers must adjust to new BXGY discount line folding behavior.

Ajax API cart tokens now have a c1- prefix. Ensure apps/themes handle tokens flexibly, avoiding hard-coded assumptions about format or length.

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

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

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

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

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

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 version 2023-07, selected partners can use the new customerPaymentMethodGetDuplicationData and customerPaymentMethodCreateFromDuplicationData to migrate subscription...

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

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 2023-07 we're introducing a new capability to translate filters.

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

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

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

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

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

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.

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.

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

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.

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.