Developer changelog

GraphQL Admin API 2023-01 adds webhook support for subscription billing cycles and new error codes. New topics: subscription_billing_cycle_edits_create, delete, and edits_update.

The Localization API now supports online store media as a localizable resource. Metafield file references and "image"...

On December 6, we released new designs that make it easier for developers to showcase the value of their apps and for merchants to discover the right apps for their businesses, including:

*...

The gateway, payment_details, and processing_method properties on Order API are deprecated. Use Transaction API for alternatives. Removal in Jan 2023, official in 2023-04 API version.

Shopify Functions now available for Plus brands without checkout.liquid customization, enabling custom discount Functions via apps. Rollout to eligible shops will take weeks.

As of the Admin API 2023-01 release candidate, Due on Fulfillment is now a Payment Terms type available to all 3rd party apps.

With this change, apps can create and update orders and draft...

Accelerated checkout buttons will now always appear in checkout even if customers have previously seen them in cart. This change will gradually roll out to eligible shops over the next two weeks. ...

App highlights added to store listings enhance merchant decision-making. From Dec 1, Partner Dashboard shows how to achieve these, boosting app visibility and merchant engagement.

As of 2023-01, the authorV2 field is being removed from the Storefront API. It was previously used to reference nullable author scenarios. As a result, the following changes are being made:

*...

Merchants based in Kuwait can now add governorates to their shipping zones.

As a result, merchants in this region can give their customers the opportunity to provide more accurate address...

The 'Speed Tested' app highlight now reflects recent performance using Google Lighthouse, focusing on response time and error rate for shipping apps with sufficient installs and requests.

With the latest addition of theme support to Shopify CLI 3.x, Shopify CLI 2.x has been scheduled to sunset on May 31, 2023....

You can now use Line Item Shopify Scripts with the [Storefront API Cart...

Updated App Design Guidelines: Use App Bridge's Navigation Menu for multi-section apps. Responsive layout requirement highlighted. Clarified table width usage in single-column layouts.

Starting November 1, 2022, you can self-categorize your app once using the app submission form in the Partner Dashboard. Categories can be chosen by selecting up to two tags from our updated app...

Merchants can now customize subscription shipping rate names, visible in checkout, admin orders, and emails. Default names apply if no specific rates are set.

Shopify Functions now let developers customize discount logic for non-Plus merchants, offering cart and product discounts with fixed or percentage reductions. Plus support is pending.

Shopify CLI 3.20 adds theme support and CI/CD integration for theme actions like push, pull, and publish. Most commands remain unchanged, enhancing developer workflow efficiency.

We've implemented an automatic GIF to animated WebP conversion process in our image processing pipeline, which improves performance by reducing delivered bytes by up to 50%.

For more...

API 2023-01 deprecates shippingOptions in SubscriptionDraft, replacing it with deliveryOptions for Local Delivery and Pickup support.

We've added the video setting. You can use the video setting to surface videos uploaded to the [Files...

Shopify now sends a unique Payment ID to payment providers for each checkout. Use it to sync order info. IDs cover successful/pending payments, excluding captures/refunds.

Added productCategory to Product for tax rate determination; deprecated standardizedProductType and customProductType. Impacts US tax rates, future global tax applications.

Shopify's cookies policy update adds three required cookies for customer login. Apps must not block them. Two new cookies enhance analytics. Update cookie management apps promptly.

Storefront API now supports CORS for SSL domains, adding headers for secure resource sharing. This enables accurate cart event tracking from non-Online Store API clients.

As of GraphQL Admin API version 2022-10, you can query for a CheckoutProfile, or mulitple CheckoutProfiles, providing insights about existing checkout profiles on your shop.

Learn...

Checkout extensibility now lets developers build apps for Shopify Plus, adding custom UI elements, tracking events, and using branding API for tailored checkout experiences.

As of GraphQL Admin API version 2022-10, you can use Web Pixel Extensions to connect your marketing and analytics pixels to a merchant's online store for collecting customer events.

Learn...

The Fulfillment API's cancel endpoint is now deprecated. Migrate to Fulfillment Orders by the 2023-04 release. A migration guide is available for assistance.

Admin API 2022-10 adds transactional_sms_disabled to Shop object in GraphQL and REST APIs. The "shop/update" webhook now triggers on changes to this field.

GraphQL and REST Admin APIs now include merchantOfRecordApp and merchant_of_record_app_id fields in the Order object, providing Merchant of Record app details for supported applications.

As of 2022-10, Location resources support metafields. Use metafields APIs to store additional information in metafield values, like store hours, and then reference them in Liquid.

To learn more...

As of GraphQL Admin API version 2022-10, you can use the new manualHoldsFulfillmentOrders connection to fetch all the manually held fulfillment orders for a shop. Fulfillment orders can also be...

Added selected_delivery_option to CartDeliveryGroup and handle to CartDeliveryOption. New mutation cartSelectedDeliveryOptionsUpdate updates delivery options per group.

GraphQL Admin API 2022-10 introduces inventoryBulkToggleActivation mutation, enabling bulk activation/deactivation of an inventory item across up to 250 locations.

Storefront API now supports attaching shipping address preferences to guest carts via deliveryAddressPreferences in CartBuyerIdentity and CartBuyerIdentityInput objects.

GraphQL APIs now support a references connection on metafield for list reference types, enabling paginated access to underlying resources. Available in unstable, releasing 2022-10.

Retrieving a list of locations is now paginated by default. If you are a consumer of this API and have more than 50...

REST Admin API now requires an order ID for creating/updating order risks, enhancing data integrity. Previously allowed order_id: null is disallowed. This change is non-breaking.

As of GraphQL Admin API version 2022-10 when you register any option translations on a ProductVariant resource, a title translation will be automatically generated using the option...

As of Admin API version 2022-10, a new field marketing_sms_consent_enabled_at_checkout has been added to the Shop object in the REST...

The 2022-10 Admin GraphQL API adds contextualPricing to fetch prices for a CompanyLocation using companyLocationId on Product and ProductVariant.

GraphQL Admin API v2022-10 adds fields and mutations for draft orders: duplicate, create from orders, bulk tag operations, delete, reserve inventory, and access hidden fields.

As of GraphQL Admin API version 2022-10, you can use the purchasing entity input field to create and update B2B draft orders.

This will attach company, location and contact to the draft order....

As of GraphQL Admin API version 2022-10, we are adding queries, objects, and mutations to introspect and manage B2B primitives notably Companies, Company Locations, and Company Contacts with...

As of GraphQL Admin API version 2022-10, we are adding mutations so you can manage your locations using GraphQL. This will allow you to add, edit, deactivate, re-activate and delete locations. ...

As of GraphQL Admin API version 2022-10, you can now use marketingActivityCreateExternal and marketingActivityUpdateExternal mutations to create and manage marketing activities, without the...

GraphQL Admin API 2022-10 adds Subscription Billing Cycles, allowing order changes without affecting contracts, skipping orders, and combining orders to save shipping costs.

APIs now redact customer data by default. Access requires approval via Partner Dashboard. Apps must meet data protection requirements, including consent and encryption.

GraphQL Admin API 2022-10 adds market and multi-currency support for draft orders, enabling region-specific settings and multi-currency payment flows with new query fields.