The General Settings section is the starting point for configuring Local Delivery Drivers for WooCommerce Premium. These settings ensure that your store, map integration, and order statuses are properly defined before enabling driver features.
Store Address
Make sure your WooCommerce store address is set correctly.
- Go to WooCommerce > Settings
- In the General tab, enter your full store address
- Open Google Maps and search for the same address to confirm it’s recognized
If Google Maps does not recognize the address, delivery routing and tracking may not work as expected.
Delivery Drivers Page
Select the page used for the delivery driver dashboard. This page is optimized for mobile devices.
Use the dropdown to choose the correct driver page. The URL will be visible and can be shared with your delivery team.
If you are logged in as an administrator and want to test the driver panel, make sure to use a different browser. Using the same browser for both panels can cause session conflicts and logouts.
Google API Keys
To enable map and distance features, the plugin requires two Google Maps API keys with different restriction types.
Key for Website (HTTP Referrers)
Used for: Maps Embed API, Maps JavaScript API, Directions API, and Geocoding API
Key for Server (IP Addresses)
Used for: Directions API, Distance Matrix API, and Geocoding API
After entering both keys, you can click Test Your Google Keys to verify they are working.
For setup instructions, refer to our Google API Key Guide
Delivery Statuses
Use the dropdowns to configure which WooCommerce order statuses will be used during the delivery workflow.
Driver Assigned Status
This status is used when a delivery driver has been assigned to an order.
What happens in this status:
- The WooCommerce order status is updated to the selected Driver Assigned status
- This status can be set in three ways:
- Automatically when a driver claims the order from the driver panel
- Automatically through the auto-assign feature
- Manually by the admin from the order page
- The order appears in the Assigned Orders screen in the driver panel
- The driver receives an email with order details
- If enabled, the driver also receives an SMS or WhatsApp notification (only when assigned by admin or auto-assign — not when claimed)
- An order note is added with the name of the assigned driver and the user or method that performed the assignment
This status does not notify the customer or trigger tracking. It simply confirms that the order is now assigned to a specific driver.
Out for Delivery Status
This status is used when the delivery process is about to begin.
What happens in this status:
- The WooCommerce order status is updated to the selected Out for Delivery status
- This status can be set by the driver from the driver panel or by the admin from the order page
- The order appears in the Out for Delivery screen in the driver panel
- If enabled, the customer receives a notification via email, SMS, or WhatsApp informing them that their delivery is on the way
- The Start Delivery button becomes available to the driver
- The driver can plan a route from this screen with all orders that are out for delivery
Clicking Start Delivery will activate live tracking, send the tracking link to the customer, and begin the monitored delivery phase.
Failed Delivery Attempt Status
This status is used when the driver tries to deliver an order but is unable to complete the delivery.
What happens in this status:
- The WooCommerce order status is updated to the selected Failed Delivery Attempt status
- The status is set by the driver from the driver panel after selecting the order
- The driver can choose a predefined ready note (such as “Customer not available”) or enter a custom note explaining the reason for the failed attempt
- An order note is added with the driver’s message
- The order remains visible in the driver panel under its new status
- The admin can review the note and follow up as needed
This status does not trigger any automatic customer notification unless additional messaging is configured. Tracking is also disabled once the order is marked as a failed attempt.
Delivered Status
(Usually mapped to WooCommerce’s Completed status)
This status is used when the delivery has been successfully completed by the driver.
What happens in this status:
- The WooCommerce order status is updated to the selected Delivered status
- The status can be set by the driver from the driver panel or by the admin from the order page
- If enabled, the driver may be required to upload a proof of delivery, such as a signature or photo, before completing the order
- An order note is added confirming that the order was marked as delivered
- The order is removed from the driver’s active delivery list
- The order is included in the driver’s commission report, based on the commission settings
- The customer can no longer access the tracking page
This status confirms that the delivery is complete and closes the delivery workflow.
(Usually mapped to WooCommerce’s Processing status)
Order Processing Status
This status is used to indicate that the order is ready for delivery and available for driver assignment or claims.
What happens in this status:
- The WooCommerce order status is updated to the selected Order Processing status
- The order becomes visible to eligible drivers on the Claim Orders screen in the driver panel
- If the auto-assign option is enabled, the plugin can automatically assign a driver to the order once it enters this status, the order status automatically changes to the Driver Assigned status
- Drivers with the required permissions can manually claim the order if it has not yet been assigned
- Once claimed or assigned, the order status automatically changes to the Driver Assigned status
This status marks the beginning of the delivery workflow and must be correctly configured to allow orders to move forward for driver handling.
You can change these assignments at any time based on your store’s needs.
Store Address Coordinates
To calculate delivery distances, enter your store’s latitude and longitude.
To get these values:
- Open Google Maps
- Right-click on your store location
- Click What’s here?
- Copy the latitude and longitude values
- Paste them into the corresponding fields
Dispatch Phone Number
Add the main phone number that drivers should call if they have questions during delivery. This number will appear on the driver panel.