v3.x to v4.x Migration Guide
This major release upgrades the Shopify Storefront API version to 2022-07. Prior to this release, this theme used the oldest available version of the Storefront API.
Upgrading to this release is strongly advised because two breaking changes will impact users around January 1, 2023, when Shopify starts serving the version 2022-04 to users.
This release upgrades the Shopify Storefront API version to 2022-07. This Storefront API version includes two breaking changes:
These are the only changes in this release.
- Update @chordcommerce/gatsby-theme-performance to ^4.0.0
- If you have @chordcommerce/product-rss-feed as a dependency, update to ^3.0.0
As of the 2022-04 Shopify Storefront API release, Shopify IDs are no longer Base64 encoded. You may have code in your website that is encoding and/or decoding IDs. This code can be removed.
Previous versions of gatsby-starter-performance included a utility file at src/utils/shopify/index.js with two functions, encodeShopifyVariantID and decodeShopifyID. If you're using these functions in your website code, update the code as described below.
Replace this code:
With this code:
Shopify no longer supports the deprecated field presentmentPrices.
You may have references to the Shopify Storefront API version in your website code. You must update your code to use at least Storefront API version 2022-04, because that will be the oldest version that Shopify supports as of January 1, 2023.
\We suggest updating all Storefront API versions to 2022-07 for consistency. Searching your code for the Shopify Storefront API, myshopify.com/api, might be helpful. To update the version, just change the version in the Storefront API path. For example, this:
Should be replaced with this:
If you are querying the Storefront API without using
, be sure to check for breaking changes in
before upgrading the Storefront API version.