Shipping

Overview

Connect real shipping carriers so checkout can request live rates and services for physical catalog items. The screen explains that only physical products use these connections; digital and services do not.

Checkout still needs correct weight and dimensions on each Products → Physical row—this app does not replace those product fields.

Free delivery

At the top of the app, three cards set whether checkout offers free delivery—similar to how Taxes uses selectable tiles for rule types.

No free delivery keeps normal carrier quotes. Always free skips live quoting and offers a single zero-amount shipping option so customers never pay delivery on that checkout.

From a minimum subtotal still requests live carrier rates, but when the cart’s merchandise subtotal (after coupon discounts, in the checkout currency) meets the threshold you configure in your workspace currency, shipping is treated as free. Choosing this card reveals Minimum subtotal for free delivery; changes to that amount debounce toward save while you edit.

Only members who can edit company settings can change these options; the app confirms save with a toast or shows an error if the update fails.

Carrier list

When at least one carrier is connected, you see a table with the friendly name, the internal carrier account id, test vs live mode, active vs inactive status, and Edit / remove actions.

Use Add carrier (or Add your first carrier in the empty state) to start the connection flow.

Adding a carrier

Step one opens a searchable grid of carriers—including Custom Carrier if you deliver yourself with your own prices. Type to filter; carriers you already connected show a Connected badge and cannot be picked again.

After you choose a carrier, step two asks for the details that carrier needs. Big-name carriers ask for login details from your shipping account; Custom Carrier asks for a name and your zone prices instead (see below).

Custom carrier

Pick Custom Carrier when you don’t use a big shipping company—for example local delivery, bike courier, or your own van service.

Give it a name your customers will see at checkout, like “Local delivery.” Then add zones: groups of countries that share the same shipping price. For each zone you can charge a fixed amount, always offer free delivery, or offer free delivery once the order total passes an amount you set.

No login details from a shipping provider are needed—you set the prices yourself. Run a test checkout to confirm customers see the right options.

Supported carriers

These carriers match Settings → Shipping → Add carrier (same display names). With community plugins enabled on your Karrio server, the list includes carriers such as Bpost and Colissimo; the table below reflects your server when docs are viewed, or the standard offline list otherwise.

Active switch and verification

The Active switch controls whether this connection should be used. When you save with Active on, the app verifies the credentials against the carrier; if verification fails, the connection is stored inactive and you see an error so you can fix keys or ids and try again.

Saving shows a verifying state on the button until the request finishes.

Editing and removing

Edit reopens the credential dialog for that row so you can rotate keys, rename the connection id, or toggle Active. Removing a carrier asks for confirmation, then deletes the connection from the workspace.

Before to start

Place a test checkout with a real delivery address in each country or zone you sell to—bad credentials, inactive connections, or missing product weights usually surface as empty rates, errors, or unrealistic quotes at payment time.