Help centre
Radius Delivery Support
Last reviewed: August 27, 2026 · Setup guides, delivery-area testing, troubleshooting and billing help.
Email: hello@radiusdelivery.app
When reporting a problem, include your
.myshopify.com store domain, the page or feature involved, what you expected, what happened, and a screenshot if available. Do not email customer passwords, Shopify access tokens or payment-card information.
Quick start
- Install Radius Delivery from Shopify and approve the requested permissions.
- Radius Delivery is currently free with all features. No paid plan selection is required.
- Make sure every Shopify Location you want to use has a complete street address.
- Open Radius Delivery, select Add delivery location, and choose a Shopify Location.
- Set its radius or zone, enable the location, review the map, and select Save.
- Use Test a customer address with representative addresses before testing checkout.
Test one address clearly inside the area, one clearly outside it, and several addresses near important streets or edges. Then repeat the same checks in Shopify checkout. The in-app tester is a preview; checkout makes the final decision.
Included Set up circular delivery areas
Shopify locations and custom delivery origins. Delivery radii and editable polygon zones.
Complete your Shopify Locations
In Shopify Admin, open Settings → Locations. Add a street, city, region, postal code and country for every dispatch location.
Add a delivery location
Open Radius Delivery, select Add delivery location → Shopify location, and choose the location you want to serve from.
Set the radius
Enter a value from 1 to 50 and choose kilometres or miles. The map circle updates from the selected location’s coordinates.
Configure Local Pickup if needed
For a Shopify Location, enable Local pickup if customers may collect orders there. Pickup is free at checkout and is independent of the delivery radius.
Repeat for other locations
Add additional Shopify Locations and give each one its own radius. A customer can receive local delivery when at least one active origin serves the address.
Save and verify
Select Save, reload the app to confirm persistence, test customer addresses, and complete a checkout test.
Included
- Multiple Shopify Locations and a separate radius for each location
- Radius values in kilometres or miles
- Native Shopify Local Pickup configuration for Shopify Locations
- Coverage map and customer-address tester
Included Shape precise delivery areas
Shopify locations and custom delivery origins. Delivery radii and editable polygon zones. Include areas, exclusion zones and precise place exceptions.
Edit a circular boundary
- Select an active location on the map.
- Choose the map control for editing the shape.
- Drag the boundary handles around roads, rivers or the area you actually serve.
- Use Undo while editing, or reset the map to return to the radius circle.
Draw a Polygon Zone
- Choose the Polygon Zone tool.
- Select at least three map points around the service area.
- Close or finish the zone, then move individual corners if necessary.
- Crossing polygon edges are rejected, so correct the shape before saving.
Add an Include or Exclusion Area
- Select the location whose area you want to refine.
- Use Include Area for a delivery island outside the main zone.
- Use Exclusion Zone to remove an area inside it.
- If an inclusion and exclusion overlap, the exclusion always wins.
Add a custom delivery origin
- Select Add delivery location → Custom address.
- Enter a name and choose a complete suggested address.
- Set its radius or custom boundary and save.
- A custom origin does not become a Shopify Location and cannot provide Shopify Local Pickup.
Include or exclude one exact address or place
- Open Address & place exceptions.
- Select Include address / place or Exclude address / place.
- Search for a complete address and select the correct suggestion.
- Choose Match within: 50, 100, 250 or 500 metres. We recommend 100 m for most buildings because it tolerates small coordinate differences.
- Add the rule, save the configuration and test it. Address exceptions are store-wide, and an Exclude rule wins over an Include rule.
Delivery pricing by zone
Each zone can use the base price, a fixed price, or an amount or percentage adjustment to the base delivery price. Positive values add a surcharge; negative values give a reduction, such as -5 or -50%. Zone pricing requires active carrier-calculated shipping (CCS). Grow needs annual billing or a CCS add-on; Advanced and Plus support it. Shopify Basic keeps its current behavior.
In Radius Delivery, select Connect Shopify shipping. If Shopify refuses the connection, activate CCS before trying again.
In Shopify → Settings → Shipping and delivery, check that Radius Delivery is enabled for the intended shipping profiles and zones, or in market shipping settings when shipping is managed in Markets. If it is already listed as an active app option, do not add a duplicate. Otherwise add the app-calculated rate. Where available, enable new services automatically and leave handling surcharges at zero to preserve the Radius price.
In Delivery pricing, select Use base price and zone pricing. Enter the Base delivery price in the displayed store currency. Enter prices excluding tax; your platform applies its tax settings.
Select an active delivery origin. In Delivery price for this zone, choose Use base price, Fixed price, Amount adjustment (+/−) or Percentage adjustment (+/−), then enter the amount or percentage.
Percentage reductions are limited to -100%. If a reduction exceeds the base price, delivery costs 0 — free delivery. A warning appears before saving.
For an included polygon area, keep Use origin price or choose its own pricing rule. A priced inclusion area overrides its origin rule; it does not add a second surcharge.
For overlapping eligible origins, the higher Priority wins; ties use displayed order. Within that origin, overlapping priced inclusion areas follow the same priority rule. Pricing never bypasses exclusions.
Select Save, then use Address test to check the matched origin or included area, base price and final delivery price. Test addresses inside, outside and near a boundary.
Repeat the test in your actual checkout, including changing the street within the same postal code. Verify taxes and any checkout-currency conversion. Other shipping and pickup methods keep their own settings.
This option is a shipping method. Native Local delivery instructions, delivery-status actions and Flow conditions based on the delivery type do not transfer automatically. Test it, then disable the previous native Local delivery option for the same service to avoid duplicate choices.
Other shipping and pickup methods remain independent. Check Shopify backup rates, which can appear if the rate service times out. Shopify can combine charges for split shipments. Existing checkout rates can remain cached for up to 15 minutes.
Radius checks the checkout address on its private server using Mapbox geocoding. An incomplete or uncertain address, an excluded area, a currency mismatch or an unavailable quote returns no Radius rate. Test taxes, discounts, every shipping profile and split shipments before using it with customers.
Examples in USD, excluding tax. Percentages apply to the base delivery price. Zone pricing requires active carrier-calculated shipping (CCS). Grow needs annual billing or a CCS add-on; Advanced and Plus support it. Shopify Basic keeps its current behavior.
Base delivery price: $15. $15 + 50% = $22.50; $15 + $5 = $20; $15 − 50% = $7.50; $15 − $5 = $10.
Existing delivery charges stay in use until you enable and save zone pricing. Customer delivery charges are separate from the Radius app subscription.
Amount adjustment (+/−) / Percentage adjustment (+/−)
Each zone can use the base price, a fixed price, or an amount or percentage adjustment to the base delivery price. Positive values add a surcharge; negative values give a reduction, such as -5 or -50%. Percentage reductions are limited to -100%. If a reduction exceeds the base price, delivery costs 0 — free delivery. A warning appears before saving.
Which rule wins when zones overlap?
The higher origin priority wins, then displayed order. Within that origin, a matching priced inclusion area overrides the origin price. Surcharges are not stacked, and exclusion rules still apply.
Will enabling zone pricing change my other delivery methods?
Only the Radius Delivery rate uses these rules. Other carriers and pickup methods remain independent. Until you enable and save the feature, your existing Radius charge remains in use.
Does zone pricing work on Shopify Basic?
No. This release requires active CCS. On Shopify Basic, Radius Delivery retains its existing area controls; the new zone-pricing method is unavailable.
Use Radius Delivery with Shopify Flow
Get alerted when a local delivery is held
The Radius Delivery escalation template is now available in the Shopify Flow library. Help your team respond to held local delivery and pickup orders.
- A local delivery or pickup fulfillment is placed on hold.
- The order receives the RADIUS_ACTION_REQUIRED tag.
- Its custom.radius_delivery_status metafield becomes on_hold.
- Your operations team receives an email with the hold reason and assigned location.
First activate “Tag orders when local delivery or pickup is selected” and configure your exact checkout delivery method names. Replace delivery-team@example.com with your operations email address.
Install the template in Flow, review its settings, test it, then turn on the workflow. Installing Radius Delivery alone does not activate it.
Download ready-made workflows
Installing the app does not automatically create workflow drafts in your store. Import the workflows you need and configure your own copy.
Download workflows — Radius Delivery (ZIP)
- Install Shopify Flow and unpack the ZIP. Import individual .flow files in Shopify Flow; do not import the ZIP.
- Follow the included instructions and replace store-specific settings. Do not import duplicates of workflows you already use.
- Check each step, test with a controlled order, then turn on the workflow.
Delivery: 4 workflows. Set your checkout method names, internal notification email and fulfillment location. Enable classification first. The location-review workflow can place fulfillment on hold.
The archive includes English and Polish instructions. Edit workflow steps in Shopify Flow. Read the detailed guidance below before activation.
Radius Delivery and Shopify Flow have separate jobs. Radius Delivery checks the customer’s approximate checkout coordinates and controls whether Shopify’s local delivery method is available. Flow reacts later to Shopify order and fulfillment events, so it can organize work without participating in the real-time checkout decision.
The four workflows below use Shopify’s native Flow triggers and actions. Radius Delivery does not read or store the order, customer name, email or shipping address for these automations.
Before installing a workflow
- Install the free Shopify Flow app from Shopify.
- Confirm the exact titles of the local delivery and local pickup methods shown in checkout.
- Confirm which Shopify Locations are allowed to prepare local deliveries.
- Choose an internal email address for operational alerts.
- Install one workflow at a time, complete the highlighted store-specific fields and run a Flow test before activation.
Classify local orders
Trigger: Order created.
Checks the selected shipping-method title, adds RADIUS_LOCAL_DELIVERY or RADIUS_LOCAL_PICKUP, and can save the delivery type in an order metafield.
Notify after payment
Trigger: Order paid.
Looks for RADIUS_LOCAL_DELIVERY, adds RADIUS_PAID, updates the operational status and emails the delivery team.
Check the fulfillment location
Trigger: Fulfillment order ready to fulfill.
Adds RADIUS_READY_TO_DISPATCH for approved locations. An unexpected location can be tagged RADIUS_LOCATION_REVIEW and placed on hold.
Escalate held orders
Trigger: Fulfillment order placed on hold.
Adds RADIUS_ACTION_REQUIRED and sends an immediate internal notification for a held local delivery or pickup order.
How to test the Flow integration
- Save the Radius Delivery configuration and confirm local delivery appears for an address clearly inside the area.
- Create a test order using that local delivery method.
- Verify the classification tag before testing payment and fulfillment workflows.
- Mark the order as paid and check the Flow activity log, tags, metafields and internal notification.
- Test both an approved and unexpected fulfillment location.
- Place the test fulfillment on hold and confirm the escalation workflow runs.
If an address is outside every active Radius Delivery area, the local delivery method is hidden during checkout and no local-delivery order is created. Because there is no order event, these workflows do not run for that rejected checkout attempt.
Common Flow questions
Why was my local order not tagged?
Check that Flow is active and that the shipping-method title in its condition exactly matches the title selected on the order. After renaming a shipping rate, update the workflow condition.
Why did the notification workflow not run?
Flow 2 depends on the tag created by Flow 1. Confirm that the first workflow completed successfully before the order was marked as paid, and review both runs in Shopify Flow activity.
Does changing a Flow workflow change my delivery zone?
No. Delivery areas remain configured inside Radius Delivery. These workflows organize orders after Shopify creates them.
How to test a delivery area
- Save the latest configuration before checkout testing.
- In Test a customer address, enter a complete street address and review the available/unavailable result.
- Test an address comfortably inside the area and another comfortably outside it.
- Test critical edge cases: both sides of a boundary street, narrow corridors, exclusions and any exact-address rules.
- Repeat representative tests in Shopify checkout. Confirm that local delivery is visible only where expected and that normal shipping remains available.
The merchant-facing tester uses Mapbox geocoding. Shopify checkout supplies its own approximate customer coordinates. A small difference between those points can place the same written address on opposite sides of a narrow or exact boundary.
Accuracy near a delivery boundary
Radius Delivery uses a deterministic, hard boundary. It does not silently add an inward or outward safety buffer. Shopify describes checkout latitude and longitude as approximate, so avoid placing a critical boundary directly through a street, large building or entrance where a small coordinate shift could change the result.
| Tested position or scenario | Verified result |
|---|---|
| Point exactly on a polygon edge | Treated as inside |
| Point approximately 50 m inside an edge | Treated as inside |
| Point approximately 50 m outside an edge | Treated as outside |
| Point in the cut-out of a concave polygon | Treated as outside |
| Overlapping Include and Exclusion rules | Exclusion wins |
| Excluded for one origin but served by another | Local delivery remains available |
| Checkout coordinates are missing or incomplete | Local delivery stays hidden; normal shipping remains |
How to reduce edge-related surprises
- Leave practical space between a zone edge and the streets or buildings you definitely want to serve.
- Test both sides of important edges in the app and in checkout.
- Use a 50, 100, 250 or 500 m address exception for a known building or place. Start with 100 m unless the site requires a tighter or wider match.
- Use an Exclusion Zone when you need to remove a larger neighbourhood or inaccessible area.
- Retest after changing Shopify Location addresses, delivery zones, Markets, shipping settings or checkout-related apps.
Common questions and troubleshooting
Why is my location missing from the map?
Open Shopify Admin → Settings → Locations and complete the location’s street address, city, region, postal code and country. Then reload Radius Delivery. Incomplete or ambiguous addresses cannot be placed reliably on the map.
Why is an address accepted or rejected unexpectedly?
Check the active origin, radius or polygon, Include Areas, Exclusion Zones and store-wide address exceptions. Exclude rules take priority when rules overlap. Confirm that the address is complete, save the latest configuration, then compare the in-app test with checkout. Near an edge, allow for the coordinate differences described above.
Delivery radii and editable polygon zones
A saved custom boundary or Polygon Zone defines delivery instead of the fallback radius. Reset the map to a circle if you want the radius control to define the area again.
Does an Exclusion Zone hide normal shipping?
No. Radius Delivery hides only local delivery methods when an address is outside the allowed area or inside an exclusion. Standard shipping methods remain available.
Why is Local Pickup unavailable for a custom address?
Shopify Local Pickup requires a native Shopify Location. A custom delivery address is only a delivery origin; it does not create a Shopify Location. Add the address in Shopify Admin first if it must offer pickup.
Free — all features
Radius Delivery is currently free with all features. No paid plan selection is required.
Why is local delivery hidden while the customer is entering an address?
Shopify may not yet have coordinates for an incomplete address. Local delivery stays hidden until Shopify can determine the position; normal shipping methods are not removed by Radius Delivery.
Free access
Radius Delivery is currently free with all features. No paid plan selection is required.
How do I request help with a charge?
Email hello@radiusdelivery.app with your store domain, charge date, amount and a short explanation. Refund or billing-adjustment requests are reviewed individually and, if approved, are processed through Shopify.
What happens when I uninstall Radius Delivery?
The App loses access to your store and future billing cycles stop through Shopify. Store-specific data that is no longer required is deleted or anonymized in accordance with our Privacy Policy, subject to limited legal, security and backup retention.
Privacy and legal requests
For privacy questions or data requests, email hello@radiusdelivery.app. If you are a customer of a merchant using Radius Delivery, contact that merchant first because the merchant controls its customer relationship and store data.
Service status and urgent issues
If Radius Delivery cannot load, save configuration or affect checkout as expected, first record the time and store domain, then email support. For urgent production-impacting issues, put URGENT and the store domain in the email subject.
Radius Delivery support will never ask you to send a password, Shopify access token, full payment-card number or customer password by email.