Skip to main content
Anchor to DeliveryOptionDefinition

DeliveryOptionDefinition

interface

Requires read_markets for queries and both read_markets as well as write_markets for mutations.

A shipping option shown to buyers at checkout. Implemented by concrete option types.

•CurrencyCode!
non-null

The currency used for all money values in this shipping option.

•String

Optional description shown to buyers.

Anchor to freeDeliveryMinimumValuefreeDeliveryMinimumValue
•MoneyV2

The cart subtotal required for free shipping. Null if no threshold is set.

•ID!
non-null

A globally unique ID for this shipping option.

•CollectionConnection

Collections that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•LocationConnection

Origin locations that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•Boolean!
non-null

Whether this shipping option is active and shown to buyers.


Was this section helpful?

Anchor to Types implemented inTypes implemented in

•OBJECT

A shipping option with rates calculated by a carrier service.

Carrier-calculated options fetch real-time rates from carriers(e.g., UPS, FedEx) at checkout instead of using merchant-defined fixed prices.

•CurrencyCode!
non-null

The currency used for all money values in this shipping option.

•String

Optional description shown to buyers.

Anchor to freeDeliveryMinimumValuefreeDeliveryMinimumValue
•MoneyV2

The cart subtotal required for free shipping. Null if no threshold is set.

•ID!
non-null

A globally unique ID for this shipping option.

•CollectionConnection

Collections that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•LocationConnection

Origin locations that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•Boolean!
non-null

Whether this shipping option is active and shown to buyers.

•DeliveryCarrierCalculatedRateGroup!
non-null

The rate group for this carrier-calculated shipping option.

•OBJECT

A shipping option with fixed-price rates.

Flat rate options charge the same price regardless of cart value or weight.

•CurrencyCode!
non-null

The currency used for all money values in this shipping option.

•String

Optional description shown to buyers.

Anchor to freeDeliveryMinimumValuefreeDeliveryMinimumValue
•MoneyV2

The cart subtotal required for free shipping. Null if no threshold is set.

•ID!
non-null

A globally unique ID for this shipping option.

•CollectionConnection

Collections that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•LocationConnection

Origin locations that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•Boolean!
non-null

Whether this shipping option is active and shown to buyers.

•String!
non-null

The name shown to buyers for this shipping option.

•DeliveryFlatRateGroupConnection

The flat rate groups for this shipping option.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•OBJECT

A shipping option with rates based on cart value.

Value-based options charge different rates depending on cart value, using tiers that define price thresholds (e.g., "$5 shipping under $50, $2 shipping over $50").

•CurrencyCode!
non-null

The currency used for all money values in this shipping option.

•String

Optional description shown to buyers.

Anchor to freeDeliveryMinimumValuefreeDeliveryMinimumValue
•MoneyV2

The cart subtotal required for free shipping. Null if no threshold is set.

•ID!
non-null

A globally unique ID for this shipping option.

•CollectionConnection

Collections that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•LocationConnection

Origin locations that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•Boolean!
non-null

Whether this shipping option is active and shown to buyers.

•String!
non-null

The name shown to buyers for this shipping option.

•DeliveryValueBasedRateGroupConnection!
non-null

The rate groups for this value-based shipping option.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•OBJECT

A shipping option with rates based on package weight.

Rates contain tiers that define package-weight thresholds. Checkout selects the appropriate tier using the package weight of the shipping allocation, or the combined package weight when allocations are grouped for weight conditions.

•CurrencyCode!
non-null

The currency used for all money values in this shipping option.

•String

Optional description shown to buyers.

Anchor to freeDeliveryMinimumValuefreeDeliveryMinimumValue
•MoneyV2

The cart subtotal required for free shipping. Null if no threshold is set.

•ID!
non-null

A globally unique ID for this shipping option.

•CollectionConnection

Collections that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•LocationConnection

Origin locations that any rate group in this shipping option applies to.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•Boolean
Default:false

Reverse the order of the underlying list.


•Boolean!
non-null

Whether this shipping option is active and shown to buyers.

•String!
non-null

The name shown to buyers for this shipping option.

•DeliveryWeightBasedRateGroup!
non-null

The rate group for this weight-based shipping option.


Was this section helpful?