Skip to Content
Shopify
    • Introduction to Shopify
    • Discover everything you can build on Shopify’s platform

      • Overview
      • Building Shopify apps
      • Building Shopify themes
      • Building Shopify channels
      • Custom development for merchants
    • Learn about Shopify’s suite of APIs

      • Overview
      • Authentication
      • Versioning
      • Getting updates
      • Rate limits
      • Search syntax
      • Response codes
      • API Terms of Use 
    • How we make Shopify’s platform safe and secure for everyone

      • Overview
      • GDPR requirements for developers
      • Checkout requirements
    • Make money by selling apps to Shopify merchants

      • Overview
      • Visibility in the Shopify App Store
      • Getting your app approved
      • Success in the Shopify App Store
      • Shopify App Store ads
    • How Shopify is building for the future with GraphQL

      • Overview
      • Benefits of using GraphQL
      • Making queries
      • Paginating queries
      • Variables
      • Mutations
      • Advanced GraphQL topics
      • More GraphQL learning resources
    • All docs
    • Create new features for the Shopify admin experience

      • Overview
      • GraphQL reference
      • REST reference
      • Access scopes
    • Add Shopify buying experiences to any platform

      • Overview
      • Getting started
      • Reference
      • Access scopes
    • Access information about your Partner business

      • Overview
      • Getting started
      • Reference
    • Customize the look and feel of online stores

      • Overview
      • Getting started
      • Liquid reference
      • Ajax API
      • Theme templates
      • Sections
      • Theme settings
    • Surface your app features wherever merchants need them

      • Overview
      • Extension points
    • Add features to Shopify’s point-of-sale apps

      • Overview
      • Getting started
      • Reference
    • Connect Shopify merchants with any marketing channel

      • Overview
      • Getting started
      • Reference
    • Automate merchant tasks with Shopify’s virtual employee

      • Overview
      • Getting started
      • Reference
    • Create complex workflows for Shopify Plus merchants

      • Overview
    • Build on Shopify’s customer-service chat platform

      • Overview
      • Reference
    • Customize Shopify’s checkout with your own payment flow

      • Overview
      • Getting started
      • Reference
    • All tutorials
    • Learn how to build, sell and maintain Shopify apps

      • Build a Shopify App with Node and React
      • Make your first GraphQL Admin API request
      • Make your first REST Admin API request
      • Authenticate a public app with OAuth
      • Authenticate a custom app with OAuth
      • Add a new app extension
      • Build a sales channel app
      • Create a checkout with Storefront API
      • Add billing to your Shopify app
      • More tutorials
    • Learn how to build and customize Shopify themes

      • Get started with Shopify themes
      • Configure theme settings
      • Learn about the template file structure
      • Add predictive search to your theme
      • More tutorials
    • All tools
    • Accelerate Shopify app development

      • Partner Dashboard
      • Shopify App CLI 
      • Shopify Rails App 
      • Shopify App Bridge
      • Embedded App SDK
      • POS App SDK
      • Admin API GraphiQL explorer
      • Storefront API GraphiQL explorer
    • Accelerate Shopify theme development

      • Theme Kit 
      • Theme Check 
      • Liquid cheat sheet 
      • Liquid code examples 
      • Theme Inspector for Chrome
    • Quickly and securely connect with Shopify APIs

      • Overview
      • Shopify API (Ruby) 
      • Shopify API (Python) 
    • Add Shopify buying experiences to any platform

      • Overview
      • JavaScript Buy SDK
      • BuyButton.js
      • Android Buy SDK
      • iOS Buy SDK
      • Unity Buy SDK
    • Build apps using Shopify’s open-source design system

      • Overview 
      • Polaris React components 
      • Polaris icon library 
      • Polaris resources 
      • Polaris on GitHub 
    • Blog 
    • Events 
    • Unite 
    • Forums 
    • Twitter 
  • Changelog
No search results
Up Down arrows to navigate Enter to select Escape to close
  • Log in
  • Sign up
Home
    • Introduction to Shopify
    • Discover everything you can build on Shopify’s platform

      • Overview
      • Building Shopify apps
      • Building Shopify themes
      • Building Shopify channels
      • Custom development for merchants
    • Learn about Shopify’s suite of APIs

      • Overview
      • Authentication
      • Versioning
      • Getting updates
      • Rate limits
      • Search syntax
      • Response codes
      • API Terms of Use 
    • How we make Shopify’s platform safe and secure for everyone

      • Overview
      • GDPR requirements for developers
      • Checkout requirements
    • Make money by selling apps to Shopify merchants

      • Overview
      • Visibility in the Shopify App Store
      • Getting your app approved
      • Success in the Shopify App Store
      • Shopify App Store ads
    • How Shopify is building for the future with GraphQL

      • Overview
      • Benefits of using GraphQL
      • Making queries
      • Paginating queries
      • Variables
      • Mutations
      • Advanced GraphQL topics
      • More GraphQL learning resources
    • All docs
    • Create new features for the Shopify admin experience

      • Overview
      • GraphQL reference
      • REST reference
      • Access scopes
    • Add Shopify buying experiences to any platform

      • Overview
      • Getting started
      • Reference
      • Access scopes
    • Access information about your Partner business

      • Overview
      • Getting started
      • Reference
    • Customize the look and feel of online stores

      • Overview
      • Getting started
      • Liquid reference
      • Ajax API
      • Theme templates
      • Sections
      • Theme settings
    • Surface your app features wherever merchants need them

      • Overview
      • Extension points
    • Add features to Shopify’s point-of-sale apps

      • Overview
      • Getting started
      • Reference
    • Connect Shopify merchants with any marketing channel

      • Overview
      • Getting started
      • Reference
    • Automate merchant tasks with Shopify’s virtual employee

      • Overview
      • Getting started
      • Reference
    • Create complex workflows for Shopify Plus merchants

      • Overview
    • Build on Shopify’s customer-service chat platform

      • Overview
      • Reference
    • Customize Shopify’s checkout with your own payment flow

      • Overview
      • Getting started
      • Reference
    • All tutorials
    • Learn how to build, sell and maintain Shopify apps

      • Build a Shopify App with Node and React
      • Make your first GraphQL Admin API request
      • Make your first REST Admin API request
      • Authenticate a public app with OAuth
      • Authenticate a custom app with OAuth
      • Add a new app extension
      • Build a sales channel app
      • Create a checkout with Storefront API
      • Add billing to your Shopify app
      • More tutorials
    • Learn how to build and customize Shopify themes

      • Get started with Shopify themes
      • Configure theme settings
      • Learn about the template file structure
      • Add predictive search to your theme
      • More tutorials
    • All tools
    • Accelerate Shopify app development

      • Partner Dashboard
      • Shopify App CLI 
      • Shopify Rails App 
      • Shopify App Bridge
      • Embedded App SDK
      • POS App SDK
      • Admin API GraphiQL explorer
      • Storefront API GraphiQL explorer
    • Accelerate Shopify theme development

      • Theme Kit 
      • Theme Check 
      • Liquid cheat sheet 
      • Liquid code examples 
      • Theme Inspector for Chrome
    • Quickly and securely connect with Shopify APIs

      • Overview
      • Shopify API (Ruby) 
      • Shopify API (Python) 
    • Add Shopify buying experiences to any platform

      • Overview
      • JavaScript Buy SDK
      • BuyButton.js
      • Android Buy SDK
      • iOS Buy SDK
      • Unity Buy SDK
    • Build apps using Shopify’s open-source design system

      • Overview 
      • Polaris React components 
      • Polaris icon library 
      • Polaris resources 
      • Polaris on GitHub 
    • Blog 
    • Events 
    • Unite 
    • Forums 
    • Twitter 
  • Changelog
  • Log in
  • Sign up
  • About
  • Careers
  • Press and Media
  • Shopify Plus
  • Sitemap

Concepts

  • Introduction to Shopify
  • Ways to build
    • Building apps
      • Subscription APIs FAQ
    • Building themes
    • Building channels
    • Custom development work
  • Using Shopify APIs
    • Authentication
    • Versioning
      • Getting updates
      • API health report
      • Private apps
      • Developer previews
      • API version release notes
        • 2021-04 (Release candidate)
        • 2021-01
        • 2020-10
        • 2020-07
        • 2020-04
        • 2020-01
        • 2019-10
        • 2019-07
        • 2019-04
    • Rate limits
    • Search syntax
    • Response status codes
    • API Terms of Service
  • Trust and security
    • GDPR requirements for developers
  • Shopify App Store
    • Visibility in the Shopify App Store
    • Getting your app approved
      • App requirements
      • The review process
      • Testing your app
      • Submitting your app
      • Data and user privacy
        • App privacy policies
        • Data rights of individuals
        • Marketing and advertising
        • App privacy policy template
    • Success in the Shopify App Store
      • Prohibited actions on the Shopify App Store
      • Getting featured
      • Marketing through Shopify
        • Tracking your listing traffic
      • Marketing externally
        • Writing a press release for your app
      • Shopify brand assets
      • Managing app reviews
      • Supporting your app
      • Sunsetting your app
      • Offering discounts to Shopify employees
    • Shopify App Store ads
      • Getting started
      • Creating ads
      • Managing ads
      • Ad reporting
      • Ad billing
      • Ad permissions
      • Frequently asked questions
  • GraphQL at Shopify
    • Benefits of using GraphQL
    • Making queries
    • Mutations
    • Variables
    • Paginating queries
    • Advanced GraphQL topics
    • More GraphQL learning resources

Concepts

  • Introduction to Shopify
  • Ways to build
    • Building apps
      • Subscription APIs FAQ
    • Building themes
    • Building channels
    • Custom development work
  • Using Shopify APIs
    • Authentication
    • Versioning
      • Getting updates
      • API health report
      • Private apps
      • Developer previews
      • API version release notes
        • 2021-04 (Release candidate)
        • 2021-01
        • 2020-10
        • 2020-07
        • 2020-04
        • 2020-01
        • 2019-10
        • 2019-07
        • 2019-04
    • Rate limits
    • Search syntax
    • Response status codes
    • API Terms of Service
  • Trust and security
    • GDPR requirements for developers
  • Shopify App Store
    • Visibility in the Shopify App Store
    • Getting your app approved
      • App requirements
      • The review process
      • Testing your app
      • Submitting your app
      • Data and user privacy
        • App privacy policies
        • Data rights of individuals
        • Marketing and advertising
        • App privacy policy template
    • Success in the Shopify App Store
      • Prohibited actions on the Shopify App Store
      • Getting featured
      • Marketing through Shopify
        • Tracking your listing traffic
      • Marketing externally
        • Writing a press release for your app
      • Shopify brand assets
      • Managing app reviews
      • Supporting your app
      • Sunsetting your app
      • Offering discounts to Shopify employees
    • Shopify App Store ads
      • Getting started
      • Creating ads
      • Managing ads
      • Ad reporting
      • Ad billing
      • Ad permissions
      • Frequently asked questions
  • GraphQL at Shopify
    • Benefits of using GraphQL
    • Making queries
    • Mutations
    • Variables
    • Paginating queries
    • Advanced GraphQL topics
    • More GraphQL learning resources
  • Available release notes
  • Give feedback

API version release notes

Release notes list all of the changes that are introduced by an API version. Use them to check whether your app is compatible with an API version, and what changes you might need to make before you migrate your app.

Available release notes

  • 2021-04 release notes (Release candidate)

  • 2021-01 release notes

  • 2020-10 release notes

  • 2020-07 release notes

  • 2020-04 release notes

  • 2020-01 release notes

  • 2019-10 release notes

  • 2019-07 release notes

  • 2019-04 release notes

On this page

  • Available release notes
About Careers Press and Media Shopify Plus Sitemap

Online Store

Sell online Features Examples Website editor Online retail Ecommerce website Domain names Themes Shopping cart Ecommerce hosting Mobile commerce Ecommerce software Online store builder Oberlo Dropshipping Business

Point of sale

Point of sale Features Hardware

Support

24/7 support Shopify Help Center Forums API documentation Free tools Free stock photos Websites for sale Hatchful

Shopify

Contact Partner program Affiliate program App developers Investors Blog topics
Facebook Twitter YouTube Instagram LinkedIn Pinterest
Terms of Service Privacy Policy
About Careers Press and Media Shopify Plus Sitemap

Online Store

Sell online Features Examples Website editor Online retail Ecommerce website Domain names Themes Shopping cart Ecommerce hosting Mobile commerce Ecommerce software Online store builder Oberlo Dropshipping Business

Point of sale

Point of sale Features Hardware

Support

24/7 support Shopify Help Center Forums API documentation Free tools Free stock photos Websites for sale Hatchful

Shopify

Contact Partner program Affiliate program App developers Investors Blog topics
Facebook Twitter YouTube Instagram LinkedIn Pinterest
Terms of Service Privacy Policy