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 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
Improved access errors in GraphQL
As of 2020-07, we are refining the error messages for GraphQL documents if the app does not have the required access scope(s). Currently, if an app does not have the required access scope, the error message returned is “access denied”. From 2020-07, the message returned will be
“Access denied for <field-name>. Required access: <access scope required> access scope”.
GraphQL Admin API changes
Below are all the changes currently introduced in the 2020-07 (Release candidate) version of the GraphQL Admin API.
Access errors in GraphQL now reference the denied resource, rather than returning a generic
access denied error. Responses will 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.
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
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
DOMAINS_CREATEvalue was added to enum
localizationExtensionswas added to object type
endpoint field of type WebhookSubscriptionEndpoint was added to the webhook subscription object. This replaces the
callbackUrl field. New create and update mutations were added to support EventBridge webhook subscriptions. For more information, see Managing webhook events with AWS EventBridge.
endpointwas added to object type
REST Admin API changes
Below are all the changes currently introduced in the 2020-07 (Release candidate) version of the REST Admin API.
one value was removed from
allocation_method in the Order resource.
across is returned in its place as the meaning is the same for explicit discounts.
You can now subscribe to domain event webhooks.
The following changes have been made to the Webhook resource.
domains/createwas added as part of accessing additional data on domains in the GraphQL Admin API.
domains/updatewas added as part of accessing additional data on domains in the GraphQL Admin API.
domains/destroywas added as part of accessing additional data on domains in the GraphQL Admin API.
Webhook resource was updated to support EventBridge webhook subscriptions. For more information, see Managing webhook events with AWS EventBridge.
addressproperty was updated to accept a URI or an EventBridge event source ARN.
Storefront API changes
Below are all the changes introduced in the 2020-07 version of the Storefront API.
A new error code was added to CheckoutErrorCode.
DISCOUNT_ALREADY_APPLIEDwas added to enum