Choose a version:

DiscountShippingDestinationSelection

union

Requires Apps must have read_discounts access scope.

The type used to target the eligible countries of an order's shipping destination for which the discount applies. For example, the discount might be applicable when shipping to all countries, or only to a set of countries.

Anchor to Possible typesPossible types

DiscountCountries

•OBJECT

The shipping destinations where the discount can be applied.

Anchor to countriescountries •[CountryCode!]! non-null: The codes for the countries where the discount can be applied.
Anchor to includeRestOfWorldincludeRestOfWorld •Boolean! non-null: Whether the discount is applicable to countries that haven't been defined in the shop's shipping zones.

DiscountCountryAll

•OBJECT

The DiscountCountryAll object lets you target all countries as shipping destination for discount eligibility.

Anchor to allCountriesallCountries •Boolean! non-null: Whether the discount can be applied to all countries as shipping destination. This value is always true.

Was this section helpful?

Anchor to Fields with this unionFields with this union

Anchor to DiscountAutomaticFreeShipping.destinationSelection DiscountAutomaticFreeShipping.destinationSelection •OBJECT: The DiscountAutomaticFreeShipping object lets you manage free shipping discounts that are automatically applied on a cart and at checkout. Free shipping discounts are promotional deals that merchants offer to customers to waive shipping costs and encourage online purchases.

The DiscountAutomaticFreeShipping object stores information about automatic free shipping discounts that apply to specific products and variants, collections, or all items in a cart.

Learn more about working with Shopify's discount model, including limitations and considerations.

Note
The DiscountCodeFreeShipping object has similar functionality to the DiscountAutomaticFreeShipping object, but customers need to enter a code to receive a discount.
Anchor to DiscountCodeFreeShipping.destinationSelection DiscountCodeFreeShipping.destinationSelection •OBJECT: The DiscountCodeFreeShipping object lets you manage free shipping discounts that are applied on a cart and at checkout when a customer enters a code. Free shipping discounts are promotional deals that merchants offer to customers to waive shipping costs and encourage online purchases.

The DiscountCodeFreeShipping object stores information about free shipping code discounts that apply to specific products and variants, collections, or all items in a cart.

Learn more about working with Shopify's discount model, including limitations and considerations.

Note
The DiscountAutomaticFreeShipping object has similar functionality to the DiscountCodeFreeShipping object, but discounts are automatically applied, without the need for customers to enter a code.

Was this section helpful?