Skip to main content

Carrier services will no longer be automatically added to the default shipping profile

Starting with GraphQL Admin API version 2026-10, creating a carrier service no longer automatically adds it to the shop’s General shipping profile.

This breaking change affects carrier services created using:

  • GraphQL Admin API: carrierServiceCreate
  • REST Admin API: POST /admin/api/{version}/carrier_services.json

Previously, active API carrier services created through these APIs were automatically added to eligible shipping zones in the shop’s General shipping profile. In API version 2026-10 and later, creating a carrier service only registers the carrier service. Shopify no longer adds that carrier service to the General shipping profile or any of its shipping zones by default.

If your app relies on the previous behavior where creating a carrier service automatically made rates available to merchants, you must update your integration so that rates are explicitly configured. Without these additional steps, merchants won’t see rates from newly created carrier services at checkout.

After creating a carrier service, you must ensure that its rates are added to a shipping profile by either:

  • (Recommended) Directing merchants to manually add the carrier-calculated rate to the appropriate shipping profile in the Shopify admin.
  • Programmatically adding the carrier-calculated rate to the appropriate shipping profile using the shipping profile APIs.

Older supported API versions will continue to use the existing automatic-add behavior for carrier services in the General shipping profile until those versions are sunset.

Learn more about carrierServiceCreate and the CarrierService REST resource.

Was this section helpful?