Bagisto Marketplace Hyperlocal connects customers with local stores and greatly transforms their shopping experience.
In addition, customers can enter their location to buy products directly from nearby seller stores.
Moreover, buyers can change or remove addresses at any time, or simply pick a point on the map.
Meanwhile, the admin defines the radius unit and search range used to find sellers around a customer.
Similarly, each seller sets the delivery distance up to which goods can be delivered from its origin.
Consequently, products from sellers outside the customer’s shipping range are automatically hidden.
As a result, shoppers only see items that can actually be delivered to their address.
Features of Laravel eCommerce Marketplace Hyperlocal Extension
- The customer can enter their location and buy products from the seller’s store.
- The customer can also change their location at any time.
- In addition, customers and guests can edit or delete their saved locations.
- Furthermore, buyers can select their exact location using an interactive map pointer.
- Customers can easily check real-time product availability in their specified area.
- The admin can configure a radius unit and range to search for nearby sellers.
- Similarly, each seller enters the delivery radius allowed from their origin store.
- Moreover, the admin can enable or disable the single-seller checkout feature.
- Consequently, seller products outside the delivery range remain hidden from buyers.
- Shoppers can quickly check seller availability around their current address.
- Finally, shipping charged by a seller using custom rates is credited to their order payout.
Requirements
- Bagisto: v2.5.0
- Bagisto Marketplace: v2.5.0.x
- Database: MySQL 8.0, MariaDB 10.11, or PostgreSQL 16
How to install the module?
First, unzip the extension and merge its packages folder into the project root directory.
Next, open the root composer.json file and add this line under ‘autoload.psr-4’:
"Webkul\\MarketplaceHyperlocal\\": "packages/Webkul/MarketplaceHyperlocal/src"
After that, refresh the autoloader by executing the following command:
composer dump-autoload
Then, register the service provider in bootstrap/providers.php after the Marketplace provider:
Webkul\MarketplaceHyperlocal\Providers\MarketplaceHyperlocalServiceProvider::class,
Finally, run the installer command below to complete the setup process:
php artisan marketplace-hyperlocal:install
Now, execute the application on your configured domain or entry point.
Admin Management: Hyperlocal Configuration
To configure settings, navigate to Admin → Configuration → Marketplace → Hyperlocal Marketplace → General.
Additionally, the Module Information section clearly displays the installed version.

Here, the store admin must configure the following key settings:
| Field | Controls |
|---|---|
| Status | Enables or disables the hyperlocal feature |
| Enable single seller checkout | Restricts a cart to products of one seller |
| Google API Key | Key used for geolocation, place search, and the map view |
| Radius Unit | Distance unit (kilometre or mile) used to match sellers to a customer (channel-based) |
Note: Make sure to enable Maps JavaScript API and Places API for your Google key.
However, if the key is missing or invalid, sample locations will be used instead.
You can easily generate a new API key via Google Maps Documentation.
In addition, the admin must define coordinates and delivery ranges for each inventory source.
Consequently, items appear only when buyers fall within an inventory source’s active range.
To manage locations, navigate to Settings » Inventory Sources in the admin panel:

Click on Add Inventory to create a new source, or click Edit for an existing one.

Specifically, enter all required inventory details, including the hyperlocal parameters:
- Locality – Search and select the location. Latitude and Longitude auto-fill immediately.
- Latitude and Longitude – The exact geographical coordinates of the source.
- Range – The maximum delivery distance allowed, based on the selected Radius Unit.
Seller Dashboard
Sellers can also define inventory locations to ensure items are shown only to nearby buyers.
As a result, location-based relevance and product accessibility improve significantly.
From the seller panel, go to Settings » Inventory Sources and fill in the location fields:

Customer Management
Enter your Location
When customers open the storefront, a prompt automatically appears asking for their location.
Buyers can either search for an address or drop a marker directly on the interactive map.
In addition, logged-in buyers can save multiple labeled addresses and set a default choice.
Meanwhile, guest customer addresses are conveniently preserved during their browser session.

Products Available – Based On Customers’ Location
Once a customer sets their location, only products available in nearby sources will appear.

Furthermore, buyers can click directly on any item to view its respective seller details.

Location Change
When a buyer updates their address with items in the cart, a confirmation popup appears.
After that, physical items unserviceable at the new address are removed from the cart.
However, downloadable and virtual products remain safely inside the shopping cart.
Single Seller Checkout
With single-seller checkout active, customers can only buy goods from one seller per order.
Therefore, attempting to add products from another seller immediately shows an alert warning.
Hyperlocal Shipping
Marketplace Hyperlocal Shipping allows sellers to deliver products based on proximity.
The carrier is configured under Admin → Configuration → Sales → Shipping Methods → Hyper Local Shipping:
| Field | Controls |
|---|---|
| Title | Method title shown at checkout (channel- and locale-based) |
| Description | Method description shown at checkout (channel- and locale-based) |
| Rate | Default rate used when a seller has no matching or flat rate (channel-based) |
| Type | Per Unit charges the rate for each unit of a product (rate × quantity); Per Product charges it once for each product line, whatever its quantity |
| Status | Enables or disables the carrier (channel-based) |
In addition, the admin can view and import shipping rates under Marketplace » Hyper Local Shipping.
Meanwhile, sellers can manage their custom rates under HL Shipping in their seller panel:
- Shipping Rate – Distance and weight rates, added manually or imported via CSV.
- Default Shipping Rate – A flat shipping rate applied when no custom band matches.
Specifically, each seller configures delivery ranges and distance-based rates individually.
Cart items are priced using matching distance bands, falling back to seller flat rates.
Furthermore, shipping charges collected from custom seller rates are credited to that seller.
Conversely, orders priced using the store default rate stay with the marketplace admin.

Finally, available hyperlocal delivery options are calculated and shown during checkout.

Support
In summary, this guide explains how the Laravel eCommerce Marketplace Hyperlocal Extension operates.
For any queries or doubts, feel free to reach out to our team at [email protected].
In addition, you can raise an instant support ticket at our HelpDesk System.
Finally, explore our Laravel Development Services and Quality Bagisto Extensions.
Current Product Version - v2.5.0
Supported Framework Version - Bagisto v2.5.0
Be the first to comment.