Delivery Customization
Overview
Delivery Customization allows you to control which delivery options appear at checkout and how they’re presented. A single Shopify Function evaluates your rules against the cart, customer, product, and delivery address data, then transforms delivery options accordingly.
This is configured through the app backend (not via the Shopify Admin discount details page), giving you a dedicated management interface for delivery rules.
Plan requirement: Pro and above (max 10 rules on Pro, unlimited on Enterprise)
Use Cases
- Hide delivery options — Hide “Express Shipping” for orders under $50.
- Rename delivery options — Append “(FREE)” to free shipping options for clarity.
- Reorder delivery options — Move “Local Pickup” to the top for customers in the same city.
- Address-based rules — Hide international shipping for specific countries or provinces.
- Method type filtering — Only show pickup points for certain zip code prefixes.
Actions
Delivery customization supports three actions:
| Action | Description |
|---|---|
| Hide | Removes the delivery option from checkout entirely. |
| Rename | Changes the delivery option name. Supports three modes: replace, append, or prepend. |
| Move | Reorders the delivery option to a specific position (index) in the list. |
Delivery Option Matching
Each rule specifies which delivery options it targets. Four matching scopes are available:
| Scope | Description |
|---|---|
| All | Applies to every delivery option. |
| By Title | Matches by option title using: exact, contains, startsWith, or endsWith. |
| By Method Type | Matches by delivery method type: SHIPPING, LOCAL, PICK_UP, PICKUP_POINT, or NONE. |
| By Cost | Matches by delivery cost using numeric operators (e.g., greater than, less than, between). |
Condition Support
Delivery customization supports all standard cart-level and product-level conditions, plus four delivery-specific conditions based on the shipping address.
Cart-Level Conditions
customerTag, customerIsAuthenticated, customerOrderCount, customerTotalSpent, cartSubtotal, cartTotalQuantity, cartLineCount, market, cartAttribute
Product-Level Conditions
productTag, productType, productVendor, lineQuantity
Delivery-Specific Conditions
These conditions are unique to delivery customization and evaluate against the delivery address:
| Condition | Operators | Description |
|---|---|---|
| Delivery Country | isAny, isNone | Match by ISO country code (e.g., US, CA, GB). |
| Delivery Province | isAny, isNone | Match by province or state code. |
| Delivery City | isAny, isNone, contains | Match by city name. |
| Delivery Zip | isAny, isNone, startsWith | Match by postal/zip code or prefix. |
Conditions can be combined with AND/OR logic, just like discount rule groups.
Example Configurations
Hide Express Shipping for Small Orders
Hide “Express Shipping” when the cart subtotal is under $50:
- Condition: Cart subtotal less than $50
- Action: Hide
- Target: Delivery options with title containing “Express”
Hide Local Pickup for Non-US Customers
Hide local pickup and pick-up options for customers outside the US:
- Condition: Delivery country is none of
US - Action: Hide
- Target: Delivery options with method type
LOCALorPICK_UP
Rename Free Shipping Options
Append “(FREE)” to any delivery option that costs $0:
- Condition: None (applies to all orders)
- Action: Rename (append mode, value: ” (FREE)”)
- Target: Delivery options with cost equal to $0
Restrict Shipping by Province
Hide standard shipping for orders to Hawaii and Alaska:
- Condition: Delivery province is any of
HI,AK - Action: Hide
- Target: Delivery options with method type
SHIPPING
Differences from Payment Customization
| Aspect | Payment Customization | Delivery Customization |
|---|---|---|
| Plan | Enterprise only | Pro+ |
| Max rules (Pro) | N/A | 10 |
| Actions | Hide, Rename, Move, Payment Terms, Order Review | Hide, Rename, Move |
| Target matching | By payment method name | By title, method type, or cost |
| Extra conditions | None | 4 delivery address conditions |
Managing Delivery Customizations
Delivery customizations are managed from the app’s Delivery Customizations page:
- List view — See all delivery customizations with their status, rule count, and toggle controls.
- Create/Edit — Build rules with conditions, actions, and delivery option matching.
- Enable/Disable — Toggle individual customizations on or off without deleting them.
- Delete — Remove customizations you no longer need.
Next Steps
- Payment Customization — Control payment methods at checkout.
- Billing & Pricing — Review plan requirements for delivery customization.
- Cart-Level Conditions — Reference for available condition types.