Wayfinder logoWayfinder

Shipping Rates

Configure zone-based rates with Shopify's Carrier Calculated Shipping API.

How it works

Wayfinder sends its prices to checkout using Shopify’s Carrier Calculated Shipping, the same system used for live rates from carriers like UPS or FedEx. When a customer reaches the shipping step:

  1. Shopify asks Wayfinder for rates

    Wayfinder uses the pin the customer dropped on the map. If there isn’t one, it uses the shipping address entered at checkout.

  2. Wayfinder finds matching zones

    It checks the location against every drawn zone and the address against every postal code zone.

  3. Matching rates are shown at checkout

    Each matching zone adds one option, using the zone’s Rate Name and Price with the zone name underneath.

Enable carrier-calculated rates

  1. Open Delivery Zones & Rates in Wayfinder

    Find the Carrier Service Status panel at the top of the page.

  2. Click Install

    Wayfinder registers itself as a shipping carrier on your store. When it’s done, the panel shows that the carrier service is active.

  3. Add Wayfinder to your shipping profile

    Installing the carrier service doesn’t show it at checkout yet. You still need to add it to a shipping profile, as shown below.

Shopify plan requirement

Carrier Calculated Shipping is included with Shopify Advanced and Plus. On other plans you may need to add it to your subscription or switch to annual billing. If the install fails, contact Shopify Support and ask them to turn on the Carrier Calculated Shipping feature. Shopify’s guide.

You can create and edit zones before you install the carrier service. Until it’s installed, though, their prices won’t appear at checkout.

Add Wayfinder to your shipping profile

Shopify only shows carrier rates in the shipping profiles and shipping zones you add them to. Do this once after installing the carrier service. Until you do, Wayfinder’s rates won’t show at checkout, even if your delivery zones are set up correctly.

Two kinds of “zones”

Shopify’s shipping zonesare broad regions, such as “United States” or “Domestic”. Wayfinder’s delivery zones are the precise areas you draw in the app. Add Wayfinder to the Shopify shipping zone that contains your Wayfinder delivery zones. Wayfinder then decides which of its rates apply to each address.

  1. Open shipping settings

    In Shopify admin, click Settings (bottom left), then Shipping and delivery.

  2. Open your shipping profile

    Under Shipping, find General shipping rates (the default profile, which covers all products) and click Manage.

  3. Find the right shipping zone

    Scroll to Shipping zonesand find the zone for the country or region you deliver in. If you don’t have one, click Create zone, name it (e.g. “Local”), select your country or states/provinces, and click Done.

  4. Add a carrier rate

    In that zone, click Add rate. Choose Use carrier or app to calculate rates.

  5. Choose Wayfinder

    In the Shipping carrier dropdown, select Wayfinder.

    Under services, make sure Wayfinder’s services are selected, including any option to automatically include new services. Wayfinder names its rates after your delivery zones, so new zones you create later will show up without coming back here.

  6. (Optional) Add a handling fee

    Shopify lets you add a percentage and/or flat fee on top of every Wayfinder rate. Leave it blank to charge exactly the prices set in Wayfinder.

  7. Save

    Click Done, then Save at the top of the page.

If you use more than one shipping profile

If some products are in a custom shipping profile (listed under Custom shipping rates), repeat the steps for each profile containing products you deliver locally. A cart with products from several profiles only gets rates that every profile offers. So if one profile is missing Wayfinder, its rates won’t show for that cart.

Should I keep my other rates?

  • Delivery only, no shipping: remove any other rates in that shipping zone. Customers will then only see Wayfinder rates, and addresses outside your delivery zones will have no delivery option.
  • Delivery and shipping: keep your normal rates. Customers inside a Wayfinder zone see both; everyone else sees only your normal rates.
  • Shopify’s own Local delivery (under Shipping and delivery → Local delivery) is separate from Wayfinder. If both are on, customers may see two local delivery options, so you’ll usually want to turn Shopify’s off.

Test it

  1. Drop a pin inside one of your zones

    On your storefront, add a product to the cart, open the Wayfinder map, and confirm a location inside a delivery zone.

  2. Go to checkout

    Enter a matching shipping address. In the shipping method step, you should see your zone’s Rate Name and price, with the zone name underneath.

  3. Try an address outside your zones

    Wayfinder’s rates should disappear. Only your other Shopify rates, if any, will show.

Setting prices

  • Each zone has a flat price. Set it to 0 to offer free delivery in that zone.
  • To make specific products free, or stop them being delivered to a zone, add Product Rules to the zone.
  • Pickup stores can have their own price, shown as “Store name — Pickup”.
  • For distance-based pricing, draw zones in rings (e.g. 0–5 km, 5–10 km), each with its own price.

Addresses outside your zones

If an address isn’t in any zone, Wayfinder returns no rates. The customer will only see the other shipping methods you’ve set up in Shopify. If you have none for that area, they won’t be able to check out with delivery, which is usually what you want for local-only delivery.

Troubleshooting

  • No Wayfinder rates at checkout: check that the carrier service is installed, that Wayfinder is added to your shipping profile (including any custom profiles), and that the test address really is inside one of your zones.
  • Wrong zone matched:make sure the customer confirmed their pin on the map. Without a pin, Wayfinder falls back to Shopify’s estimate of the address, which can be less precise.
  • Still stuck? Contact us with your store URL and a test address.