---
title: DeliveryProfile - GraphQL Admin
description: |-
  A shipping profile that defines shipping rates for specific [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects. Delivery profiles determine which products can ship from which [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects to which zones, and at what rates.

  Profiles can associate with [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) objects to provide custom shipping rules for subscriptions, such as free shipping or restricted delivery zones. The default profile applies to all products that aren't assigned to other profiles.

  Learn more about [building delivery profiles](https://shopify.dev/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles).
api_version: 2025-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/objects/deliveryprofile
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/objects/deliveryprofile.md
---

# Delivery​Profile

object

A shipping profile that defines shipping rates for specific [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects. Delivery profiles determine which products can ship from which [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects to which zones, and at what rates.

Profiles can associate with [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) objects to provide custom shipping rules for subscriptions, such as free shipping or restricted delivery zones. The default profile applies to all products that aren't assigned to other profiles.

Learn more about [building delivery profiles](https://shopify.dev/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles).

## Fields

* active​Method​Definitions​Count

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

  non-null

  The number of active shipping rates for the profile.

* default

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

  non-null

  Whether this is the default profile.

* id

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

  non-null

  A globally-unique ID.

* locations​Without​Rates​Count

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

  non-null

  The number of locations without rates defined.

* name

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

  non-null

  The name of the delivery profile.

* origin​Location​Count

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

  non-null

  The number of active origin locations for the profile.

* product​Variants​Count

  [Count](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Count)

  How many product variants are in this profile.

* profile​Items

  [Delivery​Profile​Item​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/DeliveryProfileItemConnection)

  non-null

  The products and variants associated with this profile.

  * first

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

    ### Arguments

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

  * after

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

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

  * last

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

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

  * before

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

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

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  * sort​Key

    [Profile​Item​Sort​Keys](https://shopify.dev/docs/api/admin-graphql/2025-01/enums/ProfileItemSortKeys)

    DeprecatedDefault:ID

  ***

* profile​Location​Groups

  [\[Delivery​Profile​Location​Group!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DeliveryProfileLocationGroup)

  non-null

  The location groups and associated zones using this profile.

  * location​Group​Id

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

    ### Arguments

    Filter the location groups of the profile by location group ID.

  ***

* selling​Plan​Groups

  [Selling​Plan​Group​Connection!](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/SellingPlanGroupConnection)

  non-null

  Selling plan groups associated with the specified delivery profile.

  * first

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

    ### Arguments

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

  * after

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

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

  * last

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

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

  * before

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

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

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  ***

* unassigned​Locations

  [\[Location!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Location)

  non-null

  List of locations that haven't been assigned to a location group for this profile.

* unassigned​Locations​Paginated

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

  non-null

  List of locations that have not been assigned to a location group for this profile.

  * first

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

    ### Arguments

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

  * after

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

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

  * last

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

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

  * before

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

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

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  ***

* zone​Country​Count

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

  non-null

  The number of countries with active rates to deliver to.

### Deprecated fields

* legacy​Mode

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

  non-nullDeprecated

* product​Variants​Count​V2

  [Delivery​Product​Variants​Count!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DeliveryProductVariantsCount)

  non-nullDeprecated

***

## Map

### Fields and connections with this object

* <->[DeliveryProfileConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2025-01/connections/DeliveryProfileConnection#returns-nodes)
* {}[DeliveryProfileEdge.node](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/DeliveryProfileEdge#field-DeliveryProfileEdge.fields.node)
* {}[ProductVariant.deliveryProfile](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/ProductVariant#field-ProductVariant.fields.deliveryProfile)

***

## Queries

* [delivery​Profile](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/deliveryProfile)

  query

  Retrieves a [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) by ID. Delivery profiles group shipping settings for specific [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) objects that ship from selected [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects to \[delivery zones]\(<https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryZone> with defined rates.

  Learn more about [delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment#whats-a-delivery-profile).

  * id

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

    required

    ### Arguments

    The ID of the DeliveryProfile to return.

  ***

* [delivery​Profiles](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/deliveryProfiles)

  query

  Returns a paginated list of [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) objects for the shop. Delivery profiles group [`Product`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Product) and [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects that share shipping rates and zones.

  Each profile contains [`DeliveryLocationGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryLocationGroup) objects that organize fulfillment [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects and their associated delivery zones. [`DeliveryZone`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryZone) objects define geographic regions with specific shipping methods and rates. Use the [`merchantOwnedOnly`](https://shopify.dev/docs/api/admin-graphql/latest/queries/deliveryProfiles#arguments-merchantOwnedOnly) filter to exclude profiles that third-party apps manage.

  Learn more about [delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment#whats-a-delivery-profile).

  * merchant​Owned​Only

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

    ### Arguments

    If `true`, returns only delivery profiles that were created by the merchant.

  * first

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

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

  * after

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

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

  * last

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

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

  * before

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

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

  * reverse

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

    Default:false

    Reverse the order of the underlying list.

  ***

***

## \<?>DeliveryProfile Queries

### Queried by

* \<?>[delivery​Profile](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/deliveryProfile)
* \<?>[delivery​Profiles](https://shopify.dev/docs/api/admin-graphql/2025-01/queries/deliveryProfiles)

***

## Mutations

* [delivery​Profile​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/deliveryProfileCreate)

  mutation

  Creates a [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile) that defines shipping rates for specific products and locations.

  A delivery profile groups products with their shipping zones and rates. You can associate profiles with [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) objects to customize shipping for subscriptions and pre-orders. Each profile contains [`DeliveryProfileLocationGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfileLocationGroup) objects that specify which [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects ship to which [`DeliveryZone`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryZone) objects with specific [`DeliveryMethodDefinition`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryMethodDefinition) objects and rates.

  Learn more about [building delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles).

  * profile

    [Delivery​Profile​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DeliveryProfileInput)

    required

    ### Arguments

    Specifies the input fields for a delivery profile.

  ***

* [delivery​Profile​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/deliveryProfileUpdate)

  mutation

  Updates a [`DeliveryProfile`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DeliveryProfile)'s configuration, including its shipping zones, rates, and associated products.

  Modify location groups to control which fulfillment [`Location`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Location) objects serve specific geographic areas. Add or remove shipping zones with custom countries and provinces. Create or update shipping methods with rate definitions and delivery conditions. Associate or dissociate [`ProductVariant`](https://shopify.dev/docs/api/admin-graphql/latest/objects/ProductVariant) objects and [`SellingPlanGroup`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SellingPlanGroup) objects to determine which products use this profile's shipping rules.

  The mutation supports partial updates through dedicated input fields for creating, updating, and deleting specific components without affecting the entire profile structure.

  Learn more about [building delivery profiles](https://shopify.dev/docs/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles).

  * id

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

    required

    ### Arguments

    The ID of the delivery profile to update.

  * profile

    [Delivery​Profile​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/DeliveryProfileInput)

    required

    Specifies the input fields for a delivery profile.

  * leave​Legacy​Mode​Profiles

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

    Deprecated

  ***

***

## <\~> DeliveryProfile Mutations

### Mutated by

* <\~>[delivery​Profile​Create](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/deliveryProfileCreate)
* <\~>[delivery​Profile​Update](https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/deliveryProfileUpdate)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node)

  interface

***

## ||-DeliveryProfile Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/2025-01/interfaces/Node)