Developer changelog

GraphQL Admin API 2023-01 update enhances delivery settings management with new mutation fields, efficient location queries, and Local Pickup API stability. Documentation updated for performance tips.

As of GraphQL Admin API 2023-01, you can load the associated Order or DraftOrder object when querying for a PaymentTerms object.

Until now you could only go from Order or...

As of Admin API 2023-01, there are new mutations that allow you to alter the inventory quantities at a location. State quantities reserved and on_hand are adjustable through the API. In addition,...

As of 2023-01, the Shop.billingAddress field uses a new ShopAddress type instead of the customer-centric MailingAddress type.

Since Shop.billingAddress never returns non-null first...

The 2023-01 Admin API update lets you set access for metafield definitions, controlling merchant access in your reserved namespace with PRIVATE, MERCHANT_READ, or MERCHANT_READ_WRITE.

As of 2023-01, tag fulfillment order holds with an external ID to track hold reasons and release timing using the new FulfillmentOrderHoldInput.externalId field.

Starting January 2023, some API queries may process asynchronously due to complexity. Ensure error handling for async responses. This change supports advanced segmentation filters.

As of Admin API 2023-01, you can subscribe to the new PAYMENT_SCHEDULES_DUE webhook topic to be notified of when a PaymentSchedule.due_at date is reached.

Learn more about the...

As of Admin API version 2023-01, you can use the shopifyqlQuery API to query analytical data from merchant stores to...

As of Admin API 2023-01, Shop Policy now supports the "Contact Information" policy. This policy is intended to allow users to add regulatory information like VAT and Trade number.

As of GraphQL Admin API 2023-01, you can load the associated PaymentTerms object when querying for a PaymentSchedule object.

Until now you could only go from PaymentTerms to...

As of API version 2023-01, you can create fulfillment events using the GraphQL mutation fulfillmentEventCreate which was previously only accessible via the REST API.

As of Shopify Functions API 2023-01, you can use the purchasing company as buyer identity in a B2B context to customize B2B checkout.

The new Admin API lets you create Metaobjects, enabling custom data models with granular access control and publishable entries, enhancing Shopify's data customization capabilities.

As of GraphQL Admin API 2023-01, you can use the paymentReminderSend mutation to send payment reminder emails to customers.

Learn more about sending payment reminders on...

As of GraphQL Admin API 2023-01, we are giving apps the capability for Apps to integrate into our Re-engagement marketing automation.

You will now be able to integrate Marketing Automation...

As of today, you can format your code instantly with our Liquid prettier plugin (1.0.0) for consistent code styles so you can avoid discussing styles and focus on what matters. Available both...

Trigger webhook test payloads directly from CLI, reducing dev time. Fewer emails for failed deliveries enhance monitoring by sending one email per consecutive failures over two days.

The Voice and tone section of the App Design Guidelines has been shortened, with a new link to the complete Polaris documentation...

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.

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

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:

*...

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 use Web Pixel Extensions to connect your marketing and analytics pixels to a merchant's online store for collecting customer events.

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 query for a CheckoutProfile, or mulitple CheckoutProfiles, providing insights about existing checkout profiles on your shop.

Learn...

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