Configure the Shipping Costs Based on Distance extension
Complete configuration reference for the Shipping Costs Based on Distance extension. Configure your Google Maps API connection, pricing rules, and delivery limits all from one place.
Location: Magmodules → Shipping Costs Based on Distance
General
Basic module and API settings.
Setting
Description
Enabled
Master switch for the extension.
Add Shipping Estimation to Product Page
Show estimated shipping cost on product pages. Requires customer to enter postcode.
API and Location Details
Setting
Description
API Key
Your Google Maps API key. Required for distance calculations.
Store Address
Full address of your store/warehouse. This is the origin point for all distance calculations. Include street, city, postal code, and country.
Test Credentials
Button to verify your API key and store address work correctly.
Shipping Method
Configure how the shipping method appears and calculates prices.
Name and Position
Setting
Description
Enabled
Enable this shipping method in checkout.
Title
Carrier title shown in checkout (e.g., "Local Delivery").
Method Name
Specific method name (e.g., "Distance-based shipping").
Sort Order
Display order among other shipping methods. Lower = higher position.
Calculation and Pricing
Setting
Description
Metric
Distance unit: Kilometers or Miles.
Round Distance
How to round calculated distance: No rounding, Round up, Round down, or Round to nearest.
Round Total Price
How to round final shipping price: No rounding, Round up, Round down, or Round to nearest.
Shipping Price
Dynamic pricing table. See Pricing Setup guide for details.
Address Not Found
Configure behavior when Google can't find the customer's address.
Setting
Description
If address not found
Hide shipping method or Show with message.
Message
Error message shown to customer when address not found.
Use default country on first load
Use store's default country before customer enters address.
Limit Rules
Control when the shipping method is available.
Free Shipping
Setting
Description
Enable Free Shipping
Offer free shipping above a threshold.
Minimal Order Amount
Order subtotal required for free shipping.
Minimal and Maximum Shipping Price
Setting
Description
Use Minimum and Maximum
Enable price caps.
Minimal Price
Shipping cost will never be lower than this.
Maximum Price
Shipping cost will never exceed this.
Limit by Country
Setting
Description
Ship to Applicable Countries
All Allowed Countries or Specific Countries.
Ship to Specific Countries
Select which countries this method is available for.
Limit by Order Amount
Setting
Description
Enable Minimum Order Amount
Require minimum order value to show this method.
Minimum Order Amount
Minimum cart subtotal required.
Below the Minimum Order Amount
Hide method or Show with message.
Message
Message shown when order is below minimum.
Limit by Distance
Setting
Description
Enable Maximum Distance
Set a delivery radius limit.
Maximum Distance
Maximum distance from store (in configured metric).
Above Maximum Distance
Hide method or Show with message.
Message
Message shown when customer is too far.
Conditions
Advanced product eligibility rules.
Setting
Description
Enabled
Enable product-based conditions.
Show Distance Shipping only for eligible products
Only show method if all cart items are eligible.
Allow Distance Shipping for mixed carts
Allow method when cart has both eligible and ineligible products.
Hide other shipping methods when Distance Shipping is available
Make this the only shipping option when available.
Debug & Logging
Troubleshooting tools.
Setting
Description
Debug Mode
Enable detailed logging of API calls and calculations. Logs are written to var/log/.
Magmodules sets the bar for Magento module quality and support—we check their catalog first for client feature requests, and they’re our first choice for licenses.
11 Nov 2025
Matt Austin
Possibly the fastest support response times of any Magento Extension vendor. Great extensions too!
09 Sep 2025
Jan Privé
Dankzij de heldere uitleg en snelle reactie van Magmodules kon mijn vraag, en dus mijn Magento-probleem, binnen enkele uren worden beantwoord.
Doeltreffend, zonder moeilijke termen, gewoon zo als het zou moeten zijn....
Bedankt!
05 Sep 2025
Denis Metzler
To evaluate a provider, it is not enough to consider only the product offered, but also its after-sales service, such as support and troubleshooting. Magmodules has been extremely satisfactory at all levels on multiple occasions and sets the bar at the top when comparing the competition.
02 Sep 2025
Bleijenberg winkelinrichting en materialen
Goed bereikbaar, reageren snel en denken oplossingsgericht. Een aanrader.
30 Jul 2025
Patrick Verduijn
Magmodules biedt plugins aan die van hoge kwaliteit zijn tegen een goede prijs, waar dit bedrijf in uitblinkt is de bereidheid om de zeldzame feedback & problemen met de plugins te willen onderzoeken, mee te willen denken in het debuggen van problemen en goede oplossingen toe te passen.
In mijn decennium ervaring met Magento & 3th parties is Magmodules absoluut een uniqum binnen de markt.
25 Jul 2025
Erik de Groot
Magemodules heeft hele sterke Magento extensies en een proactieve support. Al jaren heel erg tevreden over jullie service en producten!
18 Jul 2025
René Zeuner
We are using the Mollie Magento extension from Magmodules. It works excellently without flaws. Very fast, competent and friendly support. Thanks!
30 Jun 2025
R. U.
Erg goed team, reageren snel en duidelijk en hebben met toegang tot onze database erg goed geholpen (eigenlijk een gratis customization).
18 Jun 2025
Hugo de Groot
Uitstekende support! Wij gebruiken o.a. de Rich Snippets Suite extensie voor onze Magento 2 webshop (Hyvä) en hadden een specifieke vraag over structured data op PLP-pagina’s. Binnen no-time kregen we een inhoudelijk en duidelijk antwoord. Zeer prettig contact en goed onderbouwde uitleg. Absoluut een betrouwbare partner voor Magento-extensies!
