2022-04 release notes

The API version release date and the date that the version is no longer supported
Release date Date version is no longer supported
April 1, 2022 July 5, 2023

The 2022-04 version of Shopify's APIs includes new ways to search and filter customers using customer segments, organize products on storefronts, and manage fulfillment and shipping for specific delivery expectations.

The 2022-04 version of Shopify's APIs also includes new ways to manage app subscription discounts, and provides new Storefront API functionality that enables you to retrieve information about delivery methods.

What's new in 2022-04

The following features were added in version 2022-04 of Shopify's APIs.

GraphQL Admin API changes:

GraphQL Storefront API changes:

  • Query a group of delivery options that are available for the line items in a cart, based on the specified shipping address, by using the deliveryGroups connection on the Cart object.
  • Retrieve SEO information associated with a collection by using the seo field on the Collection object.
  • Embed and retrieve the origin of videos that are hosted outside of Shopify by using the originURL and embedUrl fields on the ExternalVideo object.
  • Support multiple languages on storefronts by using the Language object.
  • Replicate a merchant's online store navigation menu on custom storefronts by using the menu query.
  • Query Shopify-hosted videos and generic files that are referenced by a metafield in a shop by using the MetafieldReference union.
  • Query the ID of a shop by using the id field in the Shop object.

GraphQL Payments Apps API changes:

REST Admin API changes

  • Customer saved searches are deprecated. Use the GraphQL customer Segment object instead.
  • Retrieve the range of time that a delivery is expected to be completed, and the latest date and time when all items in a fulfillment order need to be fulfilled, by using the FulfillmentOrder resource.
  • Retrieve, add, and update information about a customer's consent to receive email marketing by using the email_marketing_consent field on the Customer resource.
  • Identify the sales channel that an order came from by using the Checkout and Order resources.