---
title: DeliveryOptionDefinition - GraphQL Admin
description: >-
  A shipping option shown to buyers at checkout. Implemented by concrete option
  types.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DeliveryOptionDefinition
  md: >-
    https://shopify.dev/docs/api/admin-graphql/latest/interfaces/DeliveryOptionDefinition.md
api_name: admin
api_type: graphql
type: interface
---

# Delivery​Option​Definition

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.

## Fields

* currency

  [Currency​Code!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CurrencyCode)

  non-null

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

* description

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  Optional description shown to buyers.

* free​Delivery​Minimum​Value

  [Money​V2](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2)

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

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally unique ID for this shipping option.

* included​Collections

  [Collection​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/CollectionConnection)

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

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    ### Arguments

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* included​Locations

  [Location​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/LocationConnection)

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

  * after

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    ### Arguments

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * first

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

* is​Active

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether this shipping option is active and shown to buyers.

***

##### Variables

```json
{
	"currency": "",
	"description": "",
	"freeDeliveryMinimumValue": "",
	"id": "",
	"includedCollections": {
		"after": "",
		"before": "",
		"first": "",
		"last": "",
		"reverse": ""
	},
	"includedLocations": {
		"after": "",
		"before": "",
		"first": "",
		"last": "",
		"reverse": ""
	},
	"isActive": ""
}
```

##### Schema

```graphql
interface DeliveryOptionDefinition {
  currency: CurrencyCode!
  description: String
  freeDeliveryMinimumValue: MoneyV2
  id: ID!
  includedCollections: CollectionConnection
  includedLocations: LocationConnection
  isActive: Boolean!
}
```