Delivery Profile
A shipping profile that defines shipping rates for specific
Product objects and
objects. Delivery profiles determine which products can ship from which
Location
objects to which zones, and at what rates.
Profiles can associate with
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 , see ),
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
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 check and
the Market.delivery field require API version 2026-07 or later.
Learn more about building delivery profiles.
Anchor to FieldsFields
- activeMethodDefinitionsCount (Int!)
- coversAllItems (Boolean!)
- createdAt (DateTime!)
- default (Boolean!)
- id (ID!)
- locationsWithoutRatesCount (Int!)
- name (String!)
- originLocationCount (Int!)
- productVariantsCount (Count)
- profileItems (DeliveryProfileItemConnection!)
- profileLocationGroups ([DeliveryProfileLocationGroup!]!)
- sellingPlanGroups (SellingPlanGroupConnection!)
- unassignedLocations ([Location!]!)
- unassignedLocationsPaginated (LocationConnection!)
- version (Int!)
- zoneCountryCount (Int!)
- productVariantsCountV2 (DeliveryProductVariantsCount!): deprecated
- Anchor to activeMethodDefinitionsCountactive•Int!
Method Definitions Count non-null The number of active shipping rates for the profile.
- Anchor to coversAllItemscovers•Boolean!
All Items non-null Whether this delivery profile covers every shippable product variant in the shop. Rates from a profile with
apply to all items at checkout, overriding any explicit product or variant assignments.- Anchor to createdAtcreated•Date
At Time! non-null The date and time when the delivery profile was created.
- Anchor to defaultdefault•Boolean!non-null
Whether this is the default profile.
- •ID!non-null
A globally-unique ID.
- Anchor to locationsWithoutRatesCountlocations•Int!
Without Rates Count non-null The number of locations without rates defined.
- Anchor to namename•String!non-null
The name of the delivery profile.
- Anchor to originLocationCountorigin•Int!
Location Count non-null The number of active origin locations for the profile.
- Anchor to productVariantsCountproduct•Count
Variants Count How many product variants are in this profile.
Show fields
- Anchor to profileItemsprofile•Delivery
Items Profile Item Connection! non-null The products and variants associated with this profile.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Profile
Key Item Sort Keys DeprecatedDefault:ID Show enum values
Arguments
- Anchor to profileLocationGroupsprofile•[Delivery
Location Groups Profile Location Group!]! 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
- Anchor to locationGroupIdlocation•ID
Group Id Filter the location groups of the profile by location group ID.
Arguments
- Anchor to sellingPlanGroupsselling•Selling
Plan Groups Plan Group Connection! non-null Selling plan groups associated with the specified delivery profile.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to unassignedLocationsunassigned•[Location!]!
Locations non-null List of locations that haven't been assigned to a location group for this profile.
Show fields
- Anchor to unassignedLocationsPaginatedunassigned•Location
Locations Paginated Connection! non-null List of locations that have not been assigned to a location group for this profile.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to versionversion•Int!non-null
The version of the delivery profile.
- Anchor to zoneCountryCountzone•Int!
Country Count non-null The number of countries with active rates to deliver to.
- Anchor to productVariantsCountV2product•Delivery
Variants Count V2 Product Variants Count! non-nullDeprecated Show fields
Anchor to QueriesQueries
- deliveryProfile (DeliveryProfile)
- deliveryProfiles (DeliveryProfileConnection!)
- •query
Retrieves a
by ID. Delivery profiles group shipping settings for specificProductobjects that ship from selectedLocationobjects 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
for details.Learn more about delivery profiles.
Show fields
- •ID!required
The ID of the DeliveryProfile to return.
Arguments
- •ID!
- •query
Returns a paginated list of
objects for the shop. Delivery profiles groupProductandobjects that share shipping rates and zones.Each profile contains
objects that organize fulfillmentLocationobjects and their associated delivery zones.objects define geographic regions with specific shipping methods and rates. Use thefilter 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
for details.Learn more about delivery profiles.
Show fields
- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to merchantOwnedOnlymerchant•Boolean
Owned Only If
true, returns only delivery profiles that were created by the merchant.- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
Anchor to MutationsMutations
- deliveryProfileCreate (DeliveryProfileCreatePayload)
- deliveryProfileUpdate (DeliveryProfileUpdatePayload)
- •mutation
Creates a
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
objects to customize shipping for subscriptions and pre-orders. Each profile containsobjects that specify whichLocationobjects ship to whichobjects with specificobjects and rates.Shops that use market-driven shipping: If the shop uses market-driven shipping (check it with
, see), 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 thefilter 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, useorand set thedelivery.shippinginput, or target an app-owned delivery profile. Thecheck and thedeliveryinput onandrequire 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
- Anchor to profileprofile•Delivery
Profile Input! required Specifies the input fields for a delivery profile.
Show input fields
Arguments
- •mutation
Updates a
's configuration, including its shipping zones, rates, and associated products.Modify location groups to control which fulfillment
Locationobjects 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 dissociateobjects andobjects 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
, see), 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 thefilter 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, useand set thedelivery.shippinginput, or target an app-owned delivery profile. Thecheck and thedeliveryinput onrequire 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
- •ID!required
The ID of the delivery profile to update.
- Anchor to profileprofile•Delivery
Profile Input! required Specifies the input fields for a delivery profile.
Show input fields
Arguments
- •ID!