> ## Documentation Index
> Fetch the complete documentation index at: https://codebeans-shipping-rules-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting up dynamic rates

> Add brand-new rates calculated live at checkout through a carrier service callback.

Dynamic rates are different from every other rule type in this app: instead of hiding, sorting, or renaming a shipping method that Shopify already knows about, they **add a brand-new rate** that's calculated live and returned through a carrier service callback at checkout.

You'll find them in their own **Dynamic Rates** tab, separate from the customizations list.

![Dynamic Rates tab and requirements banner](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/07-dynamic-rates-tab.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=4843dac69b4c02360b4246c2c399eaa7)

Dynamic Rates tab and requirements banner

## Before you start

Dynamic rates require the **Ultimate** plan — see [Choosing a plan](https://codebeans-shipping-rules-pro.mintlify.site/plans/choosing-a-plan.md).

The requirements banner on this tab will tell you if the carrier service hasn't been registered yet for your store — that has to happen before any dynamic rate can appear at checkout. If it hasn't, follow the prompt on the banner; the app registers the carrier service automatically.

## Creating a rate

With no rates configured yet, the tab shows an empty state:

![Dynamic rates editor, no rates yet](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/28-dynamic-empty.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=fa8bbde8c64dd16f4324250dfda2ed01)

Dynamic rates editor, no rates yet

A dynamic rate has two halves: the **conditions** that decide when it applies, and the **rates** it offers when they match.

### 1. Name it

Give the rule a **Title**. This is for your own reference — the customer never sees it.

### 2. Set the conditions

Pick a **Match type** — **AND** (every condition must be true) or **OR** (any one is enough) — then add your conditions with **Add condition**.

You can add up to **5 conditions**, each with up to **5 sub-conditions**. Sub-conditions test the same field more than once, which is how you express a range: "cart total is greater than 50" and "cart total is less than 200" on one condition.

Conditions cover the cart, the customer, the destination and origin addresses, individual line items, and the rate's own currency and locale — 41 in total. See [Dynamic rate conditions](https://codebeans-shipping-rules-pro.mintlify.site/dynamic-rates/conditions.md) for the full list and the operators each field accepts.

The **Summary** panel on the right restates the conditions as you build them, and carries the rule's Active/Draft status:

![Summary panel — status, and each condition with how it joins the next](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/40-dynamic-summary.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=1965cc8060e7f9b3225f923a5ce06a6a)

Summary panel — status, and each condition with how it joins the next

> [!WARNING]
>
> With **OR** selected, every condition is enough on its own — the rate quotes when one matches even if the rest fail. The editor warns you when this is likely to surprise you.

### 3. Add the rates to show

Under **Rates to show**, use **Add rate** to set the rate name, price and type. You can choose a **Fixed** amount or a **Percent**-based rate, add an optional description, and a live checkout preview shows how the label and price will look to the customer.

![Rate info modal (create) — Fixed/Percent + checkout preview](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/29a-rate-info-modal.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=d86daf50be276b33c205b3b06d879090)

Rate info modal (create) — Fixed/Percent + checkout preview

> [!WARNING]
>
> Each rate has its own **Enable** switch. A rate that's saved but not enabled will never show at checkout — remember to switch it on.

Once saved, the rate shows up as a configured, enabled row:

![One rate configured and enabled](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/29-dynamic-rate-configured.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=7788ba04ed7fd133fc29c1f2ecad9a60)

One rate configured and enabled

## Editing a rate

Reopen a rate from its row to change the amount, type, or label.

![Edit rate modal — editing an existing rate](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/29b-rate-edit-modal.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=3ce696834ef752165014c9711696ab1d)

Edit rate modal — editing an existing rate

## Multiple rates

You can configure more than one dynamic rate — for example, a fixed-price option alongside a percent-based one — and the carrier service will return every enabled rate whose conditions match.

![Two rates — fixed and percent](https://mintcdn.com/codebeans-shipping-rules-pro/q4ulWG3dWji5cRla/images/30-dynamic-multiple-rates.jpg?fit=max\&auto=format\&n=q4ulWG3dWji5cRla\&q=85\&s=10177d532b5079c58c666edd8babaa2a)

Two rates — fixed and percent

> [!NOTE]
>
> Dynamic rates are stored as shop metafields and evaluated at request time by the `/api/getshippingrates` carrier service callback — they don't go through the same delivery-customization pipeline as Simple, Advanced, or the organizer rule types.

> [!NOTE]
>
> Shopify gives a carrier service a few seconds to answer before it drops the rates from checkout. The app works within that limit, so a very large catalog or a long condition list can occasionally mean a quote doesn't make it in time. If rates appear intermittently, simplifying the conditions usually settles it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.