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: All plans (max 5 rules on Starter, 10 on Pro, 30 on Enterprise)
Use Cases
| Use Case | Description |
|---|---|
| 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:
| Setting | Value |
|---|---|
| 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:
| Setting | Value |
|---|---|
| Condition | Delivery country is none of US |
| Action | Hide |
| Target | Delivery options with method type LOCAL or PICK_UP |
Rename Free Shipping Options
Append “(FREE)” to any delivery option that costs $0:
| Setting | Value |
|---|---|
| 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:
| Setting | Value |
|---|---|
| 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 | All plans | All plans |
| Max rules (Pro) | 10 | 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:
| Feature | Description |
|---|---|
| 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
- Cart & Checkout Validation: block or warn buyers at checkout based on cart and delivery conditions.
- Payment Customization: control payment methods at checkout.
- Checkout Upsells: offer pre-purchase products inside checkout (Pro+).
- Cart-Level Conditions: reference for available condition types.