2020-07 release notes
|Release date||Date version is no longer supported|
|July 2, 2020||July 2, 2021|
The 2020-07 release contains changes to support AWS EventBridge integration, annual billing through the Shopify Billing API, and better errors in GraphQL. This release also offers more flexible explicit discounts, exposes tips on orders, and extends locale-specific support for collecting additional information at checkout.
What’s new in 2020-07
The following features were added in version 2020-07 of Shopify's APIs.
- Apps now support integration with Amazon EventBridge to receive Shopify webhooks using an event bus. As a result, [Webhooks]/api/admin/rest/reference/events/webhook) now support ARN addresses.
- Shopify's Billing API now offers annual billing in GraphQL.
- Access errors in GraphQL now reference the denied resource, rather than returning a generic
- The CPF/CNPJ can now be collected at checkout for merchants in Brazil. This information is exposed through the API using a new localizationExtensions connection.
- The total tip amount received on an order is now available via
- The API now offers additional data on domains associated with a given shop using the new
shop.domainsfield and webhook events.
These changes require special attention. If your app uses these API resources and you don’t upgrade to a more recent API version, then your app will break.
Allocation method for discounts
We updated the allocation method for discounts that have set the
explicit. Previously, Shopify applied these discounts to a single line item, which corresponded to an allocation method of
one. With this change, the allocation methods will instead include
We've made this change to simplify the discount syntax, as
across functionally both discount the final price by a set amount.
Product variant resource
images value was removed from object type
GraphQL Admin API changes
Below are all the changes currently introduced in the 2020-07 version of the GraphQL Admin API.
ONE value was removed from enum DiscountApplicationAllocationMethod.
ACROSS is returned in its place as the meaning is the same for explicit discounts.
The following changes were made to the ProductVariant resource:
imagesvalue was removed from object type
Access errors in GraphQL now reference the denied resource, rather than returning a generic
access denied error. Responses now also include extensions, which consist of an error code, link to necessary documentation, and the name of the required access scope.
Learn more about access scopes in our documentation.
localizationExtensions field was added to the order object. For more information, see Get a tax ID using localization extensions .
localizationExtensionswas added to object type
totalTipReceivedwas added to object type
LocalizationExtensionPurposeenum was added
A new field was added to the BulkOperation resource.
rootObjectCountwas added to object type
A new field was added to the Customer resource.
multipassIdentifierwas added to object type
A new field was added to the DraftOrder resource.
readywas added to object type
You can now create annual billing subscriptions for your apps. To learn more, refer to Create an annual subscription.
intervalwas added to input object type
ANNUALvalue was added to enum
You can now query a shop's localized domains and subscribe to domain event webhooks.
localizationwas added to object type
domainswas added to object type
DOMAINS_UPDATEvalue was added to enum
DOMAINS_DESTROYvalue was added to enum