Welcome! We’re so excited for you to try the next major version of gatsby-source-shopify. This release addresses many longstanding developer experience challenges with the source plugin. Version 7 is beta quality, so we recommend upgrading your sites and testing before pushing to production.

<aside> ⚠️ This release introduces some breaking changes. Read below!

</aside>

Run into any issues during your upgrade? Email jack@gatsbyjs.com and follow along in this PR for more updates about this release.

How to upgrade

  1. Run npm install gatsby-source-shopify@v7-rc on your Gatsby site
  2. Private apps you have configured for Admin API access now require Read access to the Files endpoint.
  3. product.images has been replaced with a new interface: product.media. Migrate places where you used product.images to this new interface.
  4. Test! Querying for shop data may be different in this major version (as requested by the community), so some queries may break and need to be updated. Checkout the release notes for more information.