Skip to main content
object

A shipping profile that defines shipping rates for specific Product objects and ProductVariant objects. Delivery profiles determine which products can ship from which Location objects to which zones, and at what rates.

Profiles can associate with 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.

Shops that use market-driven shipping: If the shop uses market-driven shipping (check it with shop { features { marketDrivenShipping } }, see ShopFeatures.marketDrivenShipping), checkout combines the shipping rates and options from the shop's market configuration and app-owned delivery profiles. Zones and rates from merchant-managed delivery profiles are ignored. In practice, merchant-managed profiles are the profiles that the merchantOwnedOnly filter returns. Shipping options from merchant-managed delivery profiles are still saved on a shop, but these rates may differ from what buyers pay and should not be relied on. Read the current shipping configuration from the Market object's delivery.shipping field instead. The marketDrivenShipping check and the Market.delivery field require API version 2026-07 or later.

Learn more about building delivery profiles.

Anchor to activeMethodDefinitionsCountactiveMethodDefinitionsCount
•Int!
non-null

The number of active shipping rates for the profile.

•Boolean!
non-null

Whether this delivery profile covers every shippable product variant in the shop. Rates from a profile with coversAllItems: true apply to all items at checkout, overriding any explicit product or variant assignments.

•DateTime!
non-null

The date and time when the delivery profile was created.

•Boolean!
non-null

Whether this is the default profile.

•ID!
non-null

A globally-unique ID.

Anchor to locationsWithoutRatesCountlocationsWithoutRatesCount
•Int!
non-null

The number of locations without rates defined.

•String!
non-null

The name of the delivery profile.

•Int!
non-null

The number of active origin locations for the profile.

Anchor to productVariantsCountproductVariantsCount
•Count

How many product variants are in this profile.

Show fields
•DeliveryProfileItemConnection!
non-null

The products and variants associated with this profile.

Show fields

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.

•ProfileItemSortKeys
DeprecatedDefault:ID
Show enum values

Anchor to profileLocationGroupsprofileLocationGroups
•[DeliveryProfileLocationGroup!]!
non-null

The location groups and associated zones using this profile. If the shop uses market-driven shipping and this is a merchant-managed profile, these zones and rates don't affect checkout and can differ from what buyers pay.

Show fields

Arguments

•ID

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


•SellingPlanGroupConnection!
non-null

Selling plan groups associated with the specified delivery profile.

Show fields

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.


•[Location!]!
non-null

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

Show fields
Anchor to unassignedLocationsPaginatedunassignedLocationsPaginated
•LocationConnection!
non-null

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

Show fields

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.


•Int!
non-null

The version of the delivery profile.

•Int!
non-null

The number of countries with active rates to deliver to.

Anchor to productVariantsCountV2productVariantsCountV2
•DeliveryProductVariantsCount!
non-nullDeprecated
Show fields

Was this section helpful?

•query

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

If the shop uses market-driven shipping, checkout ignores the zones and rates on merchant-managed profiles, so they can differ from what buyers pay. See DeliveryProfile for details.

Learn more about delivery profiles.

Show fields

Arguments

•ID!
required

The ID of the DeliveryProfile to return.


•query

Returns a paginated list of DeliveryProfile objects for the shop. Delivery profiles group Product and ProductVariant objects that share shipping rates and zones.

Each profile contains DeliveryLocationGroup objects that organize fulfillment Location objects and their associated delivery zones. DeliveryZone objects define geographic regions with specific shipping methods and rates. Use the merchantOwnedOnly filter to exclude profiles that third-party apps manage.

If the shop uses market-driven shipping, checkout ignores the zones and rates on merchant-managed profiles, so they can differ from what buyers pay. See DeliveryProfile for details.

Learn more about delivery profiles.

Show fields

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

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

•Boolean
Default:false

Reverse the order of the underlying list.



Was this section helpful?

•mutation

Creates a 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 objects to customize shipping for subscriptions and pre-orders. Each profile contains DeliveryProfileLocationGroup objects that specify which Location objects ship to which DeliveryZone objects with specific DeliveryMethodDefinition objects and rates.

Shops that use market-driven shipping: If the shop uses market-driven shipping (check it with shop { features { marketDrivenShipping } }, see ShopFeatures.marketDrivenShipping), checkout combines the shipping rates and options from the shop's market configuration and app-owned delivery profiles. Zones and rates from merchant-managed delivery profiles are ignored. In practice, merchant-managed profiles are the profiles that the merchantOwnedOnly filter returns. A merchant-managed profile that you create is still saved, but its zones and rates have no effect on checkout while the merchant is using market-driven shipping. They apply again if the shop reverts to the legacy shipping profile system and stops using market-driven shipping. To set shipping options for a market-driven shipping shop, use marketUpdate or marketCreate and set the delivery.shipping input, or target an app-owned delivery profile. The marketDrivenShipping check and the delivery input on marketUpdate and marketCreate require API version 2026-07 or later.

Product and variant assignment still takes effect: Associating a product, variant or selling plan group moves it out of its current profile, including a profile that an app manages. That can change the rates buyers see at checkout.

Learn more about building delivery profiles.

Show payload

Arguments

•DeliveryProfileInput!
required

Specifies the input fields for a delivery profile.

Show input fields

•mutation

Updates a DeliveryProfile's configuration, including its shipping zones, rates, and associated products.

Modify location groups to control which fulfillment 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 objects and 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.

Shops that use market-driven shipping: If the shop uses market-driven shipping (check it with shop { features { marketDrivenShipping } }, see ShopFeatures.marketDrivenShipping), checkout combines the shipping rates and options from the shop's market configuration and app-owned delivery profiles. Zones and rates from merchant-managed delivery profiles are ignored. In practice, merchant-managed profiles are the profiles that the merchantOwnedOnly filter returns. Changes to the zones, rates, method definitions and conditions of these profiles are still saved, but they have no effect on checkout while the merchant is using market-driven shipping. The changes apply again if the shop reverts to the legacy shipping profile system and stops using market-driven shipping. To modify shipping options for market-driven shipping shop, use marketUpdate and set the delivery.shipping input, or target an app-owned delivery profile. The marketDrivenShipping check and the delivery input on marketUpdate require API version 2026-07 or later.

Product and variant assignment still takes effect: Associating a product, variant or selling plan group moves it out of its current profile, including a profile that an app manages. That can change the rates buyers see at checkout.

Learn more about building delivery profiles.

Show payload

Arguments

•ID!
required

The ID of the delivery profile to update.

•DeliveryProfileInput!
required

Specifies the input fields for a delivery profile.

Show input fields


Was this section helpful?

•interface

Was this section helpful?