During the app installation the Octolize Distance Based Rates rates will be automatically added for the currently existing Shipping zones in the Shopify settings at Settings → Shipping and delivery → Shipping zones:
If for some reason this does not happen and the Octolize Distance Based Rates app’s rates have not been added there by default (i.e. if a given shipping zone was created after the app had already been installed), use the + Add shipping option button to do it manually.
In the window that appears, select the following options in order:
- Rate type: Carrier or app calculated
- Carrier or app: Octolize Distance Based Rates (Rates provided by app),
then confirm everything by clicking Done:
Once the app installation process is complete, you should be automatically redirected to the app’s General Settings screen:
Octolize Distance Based Rates settings
General
Enable distance-based shipping cost calculation in your store – tick this checkbox to activate the Octolize Distance Based Rates app functionalities or untick it to deactivate them globally.
Google Maps API key * (required) – paste your own Google Maps API key to be used for the distance calculation.
If you do not have your own Google Maps API Key yet, find out how to obtain it →
After entering the Google Maps API key * and saving the changes, the Google Maps API connection status should change to Connected:
Click the Rates & Locations option in the app’s main nav menu to proceed to the next configuration screen:
Rates & Locations
This screen contains a table with all the Locations you ship from that are configured in your Shopify Settings → Locations, along with the distance-based rates you add for shipping from these locations.
On this screen you can:
- See the list of existing Locations,
- Check the Status of each Location, including which are currently Active or Inactive,
- Add a new Distance-based rate for a given Location using the + button in the Actions column,
- Open the configuration screen for a specific Distance-based rate added for a Location,
- Delete an existing Distance-based rate when it’s no longer needed.
The locations visible here are not added manually — they are automatically synced from the settings mentioned above, so if you have previously configured them there, their details will be automatically imported and displayed in the Rates & Locations table above.
To modify the way the currently existing locations are configured and to manage their status, go to Shopify Settings → Locations. All the changes made there will be reflected in the Rates & Locations table as well.
Adding distance-based rates for a specific Location
To add a new Distance-based rate for shipping from a specific Location, click the plus icon button + in the Action column next to that Location:
You will be redirected to the next screen, where you can start…
Configuring the distance-based rates
Status
asd
Shipping method
Shipping method name – enter the name for the shipping method with distance-based delivery cost calculation which will be displayed to your customers at the checkout.
Please mind that if you ship your products from multiple locations, it is highly advised to use the same Shipping method name for all of them to ensure they are displayed as one and the distance-based delivery cost is being summed up properly at the checkout.
Shipping method description – enter the shipping method’s additional description which will be displayed below its name at the checkout. You can use the {{distance}} shortcode in this field to show your customers the numerical value of the distance to their delivery address.
Filling in the Shipping method description field with the following content:
will result in the distance being displayed at the checkout the following way:
Distance
Distance units – choose whether the kilometers or miles should be used for the distance calculation.
Distance calculation method – decide how the distance between this location and the customer’s delivery address should be calculated by selecting one of the available options:
- Straight line – calculates the direct distance between two points (shop or warehouse location and delivery address) in a straight line (“as the crow flies”), without the actual path’s specifics or any existing obstacles being considered on the way,
- Driving route – uses Google Maps to calculate the actual distance that needs to be traveled to go from one point to another using the roads or routes available on the map. It considers the roads, turns, traffic and any obstacles along the way.
Please mind that the Driving route must be geographically possible to be used for the calculation. If the Distance calculation method is set to Driving route and there are no direct car routes between the location you ship your products from and the ‘Ship to’ address the customer entered at the checkout, the app will not be able to calculate the distance.
If the Driving route has been selected, an additional Travel mode option will appear below:
Travel mode – specify the transportation mode to be used for the distance calculation by choosing one of the available options:
- Driving – standard distance calculation using the road network,
- Cycling – distance calculation using the cycling paths and preferred streets (where available),
- Walking – distance calculation using the pedestrian paths and sidewalks (where available).
Cost calculation
Delivery cost calculation method – select the way how the distance-based delivery cost should be calculated when shipping from this location by choosing one of the available options:
- Rate per distance unit – select to charge your customers with a fixed rate per kilometer/mile,
- Base delivery cost + Additional rate per distance unit – choose to charge your customers with a flat rate fee as a base delivery cost and an additional rate per kilometer/mile.
Set the based delivery cost to; Additional rate per distance unit – fill in these fields with the cost your customers should be charged for delivering the products from this location.