Configuring COD Shipping Rates — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Create, order, and publish conditional COD shipping rates in Form Builder → Shipping Rates (/app/form-builder/shipping-rates) so buyers only see delivery options they qualify for and every order is priced accurately on the server.
Preconditions
Section titled “Preconditions”- You have enabled your target delivery countries in Form Builder → Form Designer (Countries card).
- You know your courier’s pricing tiers (for example, standard paid shipping below a threshold and free shipping above a threshold).
Numbered Instructions
Section titled “Numbered Instructions”1. Open the Shipping Rates Workspace
Section titled “1. Open the Shipping Rates Workspace”- In Shopify Admin, navigate to Form Builder → Shipping Rates (
/app/form-builder/shipping-rates). - Click Add shipping rate to create a new COD delivery option.
2. Define Rate Title, Description & Price
Section titled “2. Define Rate Title, Description & Price”- Enter a customer-facing Rate Name (for example,
Standard COD DeliveryorFree Express COD). - Optionally add a Subtitle / Delivery Estimate (for example,
1–3 business days). - Set the Price in your shop currency (
0for Free Shipping, or a positive amount stored in integer minor units).
3. Configure Eligibility Conditions (evaluateShippingEligibility)
Section titled “3. Configure Eligibility Conditions (evaluateShippingEligibility)”- Expand the Conditions section on the shipping rate card to restrict when the rate is offered:
- Order Subtotal Bounds (
minSubtotalMinor/maxSubtotalMinor): Offer the rate only when the discounted merchandise subtotal falls within your minimum and/or maximum bounds. - Order Weight Bounds: Restrict by minimum and/or maximum total cart weight.
- Product Eligibility (
includeProductIds/excludeProductIds): Restrict a rate to specific products or hide it when excluded products are present. - Country & Province Targeting: Limit the rate to specific ISO country codes and optional province/state codes (for example, offering same-day COD courier only in
TR→İstanbul).
- Order Subtotal Bounds (
- Arrange your rates in priority order using the list controls. The first eligible rate in your list is selected by default when the storefront form opens.
- Click Save in the SaveBar to publish the updated
cod_shipping.v1_snapshot.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”Troubleshooting Steps
Section titled “Troubleshooting Steps”- Free shipping tier appears alongside paid shipping: If you have both a paid rate (for example,
₺0 – ₺999) and a free rate (₺1,000+), setmaxSubtotalMinoron the paid rate to₺999.99so only the free rate appears once the buyer crosses₺1,000. - Rate does not appear for a specific province: Verify that the province code matches the standardized subdivision code used by the cascading Province selector.