Skip to content

Shipping Carriers

Add shipping carriers and delivery options for your store.

Carriers are the shipping providers that deliver your products to customers. You can add carriers like UPS, FedEx, DHL, or your own local delivery service, and configure delivery options with pricing for each shipping zone.

Shopper supports two types of carriers:

  • Manual carriers where you set flat-rate prices for each delivery option
  • API-connected carriers that fetch real-time shipping rates from the carrier's system (UPS, FedEx, USPS)

Accessing Carriers

  1. Click on Settings in the sidebar
  2. Select Carriers from the settings menu
Carriers list page

The carriers list shows all your configured carriers with their driver type, status, and last update date. You can enable or disable a carrier directly from the list using the status toggle.

Adding a Carrier

To add a new shipping carrier:

  1. Click the Add carrier button
  2. Fill in the carrier details
  3. Click Save
Add carrier form

Carrier Fields

FieldRequiredDescription
Carrier nameYesThe carrier's name (e.g., "UPS", "Local Delivery", "Colissimo")
DriverYesHow rates are calculated. Defaults to Manual (custom rates per zone). Choose a provider like UPS for real-time rates
WebsiteNoThe carrier's website URL
DescriptionNoA short description of the carrier

Choosing a Driver

The driver determines how shipping rates are calculated:

DriverHow it worksWhen to use
ManualYou set fixed prices for each delivery optionLocal delivery, flat-rate shipping, free shipping
UPSRates are fetched from the UPS API in real timeYou have a UPS account and want dynamic pricing
FedExRates are fetched from the FedEx API in real timeYou have a FedEx account and want dynamic pricing
USPSRates are fetched from the USPS API in real timeYou ship within the United States
select carrier driver

API-connected drivers (UPS, FedEx, USPS) require API credentials to be configured by your developer. If a driver shows a "Not configured" badge in the dropdown, the credentials have not been set up yet. See the Carriers developer documentation for setup instructions.

Managing Carriers

Editing a Carrier

To update a carrier's information:

  1. Click the pencil icon next to the carrier you want to modify
  2. Update the fields you want to change
  3. Click Save changes

Enabling or Disabling a Carrier

You can quickly enable or disable a carrier without editing it by toggling the Status switch directly in the carriers list. Disabled carriers are not shown as shipping options during checkout.

Deleting a Carrier

To remove a carrier:

  1. Click the trash icon next to the carrier
  2. Confirm the deletion

Deleting a carrier does not remove its delivery options, and a carrier that still has delivery options cannot be deleted. Remove its options from each zone first. If you have active orders using this carrier's shipping, consider disabling it instead of deleting it.

Setting Up Delivery Options

After creating a carrier, you need to add delivery options with pricing. Delivery options are configured per zone, so the same carrier can have different options and prices for different regions.

To add a delivery option:

  1. Go to Settings > Zones
  2. Select the zone where you want to add shipping options
  3. In the Shipping Options section, click Add Option
  4. In the panel that opens (for example "Shipping Option for the Europe zone"), fill in the delivery details and select the carrier. The Carriers list only shows the carriers added to this zone
  5. Click Save
Add delivery option form

Delivery Option Fields

FieldRequiredDescription
NameYesThe option name shown at checkout (e.g., "Standard Delivery", "Express 24h"). Each name can be used once per zone
PriceYesThe shipping price for this option in the zone's currency. Enter 0 for free delivery
CarriersYesThe carrier that provides this delivery option, chosen among the carriers added to the zone
DescriptionNoDetails about delivery time, up to 200 characters
VisibilityNoOff by default. Turn it on to make the option available in your store
MetadataNoOptional key-value data for custom use

Create multiple delivery options for the same carrier to offer different speed/price tiers. For example, a carrier could have "Standard (3-5 days)" at $5.99 and "Express (next day)" at $14.99.

Viewing Delivery Options

All delivery options for a zone are displayed in the zone's detail page under the Shipping Options section. Each option shows the carrier logo (when the carrier has one), the option name with an Enabled or Disabled badge, its description, and its price.

Zone shipping options list

Editing or Removing Delivery Options

To edit a delivery option, click the pencil icon next to it. To remove it, click the trash icon and confirm.

Common Setups

Here are typical carrier configurations for different store types:

Local Business

CarrierOptionPrice
Local DeliverySame-day delivery$8.00
Local DeliveryIn-store pickupFree

National Store

CarrierOptionPrice
Standard Shipping5-7 business days$5.99
Express Shipping2-3 business days$12.99
Free ShippingFree delivery (5-7 business days)Free

International Store

CarrierOptionPrice
UPS (API)Ground, Express, OvernightReal-time rates
DHLInternational Express$24.99
Free ShippingFree delivery, added in the domestic zone onlyFree

Free Shipping

To offer free shipping:

  1. Create a carrier named "Free Shipping"
  2. Add this carrier to the zone's Carriers (see Shipping Zones)
  3. Add a delivery option with a Price of 0 and use the description to say what it includes (e.g., "Delivered in 5-7 business days")

A delivery option has no minimum order amount: a free option is offered on every order in its zone. To limit free shipping to some regions, add the free option only in those zones.

You can combine free shipping with paid options. Customers see all available options at checkout and choose the one they prefer.

Best Practices

Name Clearly

Use descriptive names that include delivery time: "Standard (3-5 days)" is better than just "Standard".

Price by Zone

Set different prices for different zones. Domestic shipping is usually cheaper than international.

Offer Choices

Give customers at least 2 shipping options: a budget option and a faster option.

Test at Checkout

After setting up carriers, place a test order to verify shipping options appear correctly.

For developer details on carriers, shipping drivers, and custom driver integration, see the Carriers documentation.

Last updated on

Edit on GitHub