Menu

4 min read

Hyper Local Marketplace


A practical guide to setting up location-based product visibility using the Hyperlocal add-on in Shipturtle

Overview

The Hyperlocal add-on restricts product visibility on your Shopify storefront to customers whose location falls within a defined delivery radius. When a customer visits your store, Shipturtle detects their zip or pin code and shows only the products that can be delivered to them — hiding everything outside the serviceable area automatically. Use it when your vendors or warehouses cover specific geographic zones and you need to prevent customers from ordering products that can't reach them.

In this guide, you'll learn how to:

  • Purchase and activate the Hyperlocal add-on.
  • Set a serviceable delivery radius on merchant and vendor warehouses.
  • Enable the Collection Hyperlocal embed in your Shopify theme.
  • Understand how location-based filtering works for customers on the storefront.

1. Who This Is For

The Hyperlocal add-on involves three user roles:

  • Merchant: Purchases the add-on, configures warehouse delivery radii, and enables the storefront embed.
  • Vendor: Sets their own warehouse delivery radius so their products are shown only to customers within their serviceable area.
  • Customer: Sees only products available at their location — no setup required on their end.

2. Before You Begin

Make sure the following are in place before starting the Hyperlocal setup:

  • Shipturtle is installed and active on your Shopify store.
  • Each warehouse you want to make hyperlocal must already exist in Shipturtle, or you must be ready to create one during setup.
  • The Hyperlocal add-on requires a one-time backend configuration by the Shipturtle team before it works on your storefront. Contact team@shipturtle.com as soon as you purchase the add-on to schedule this. Do not proceed to the Shopify configuration step until the team confirms backend setup is complete.

3. How It Works (At a Glance)

Here is the end-to-end flow once the Hyperlocal add-on is active:

  1. You purchase the Hyperlocal add-on and the Shipturtle team completes a backend configuration.
  2. You (and your vendors) set a serviceable radius on each warehouse, and it fetches all zip/pin codes within that radius automatically.
  3. You enable the Collection Hyperlocal embed in your Shopify theme.
  4. A customer visits your storefront and populates their zip/pin code.
  5. Only the products belonging to warehouses that service that zip/pin code are shown. Everything else is hidden.

4. Merchant Setup

Merchant setup involves purchasing the add-on and configuring the serviceable radius on your warehouses.

Purchase the Hyperlocal add-on

  1. Open Setup & Configuration → Billing and subscription.
  2. Find Hyperlocal Add-On in the available add-ons list.
  3. Click Subscribe and confirm the charge.
  4. Email team@shipturtle.com to notify the team so they can complete the required backend configuration for your store.

Set a serviceable radius on a merchant warehouse

  1. Open Setup & Configuration → Merchant Profile → Warehouse. (For vendors, open Vendor Profile instead.)
  2. Click Add warehouse to create a new one, or click the Edit (pencil) icon on an existing warehouse.
  3. Enter the Serviceable Radius in kilometres or miles.
  4. Click Fetch PIN/ZIP.

The warehouse should be marked as the default; only then will the warehouse ZIP codes sync for it. Shipturtle fetches all zip or pin codes within the radius and associates them with the warehouse. Products assigned to this warehouse are now only visible to customers whose detected zip/pin code appears in that list.

temp

5. Shopify Configuration

The storefront location detection requires a single App Embed to be enabled in your Shopify theme. Complete this step after the Shipturtle team has confirmed backend setup is done.

  1. Go to Shopify Admin → Online Store → Themes.
  2. Click Customize on your active theme.
  3. In the top-left panel, click App embeds.
  4. Find Collection Hyperlocal and toggle it on.
  5. Click Save.
Hyperlocal_shopify_navigation

FAQs & Troubleshooting

  • What happens if Shipturtle can't detect a customer's location?
    If location detection fails — for example, because the customer denied location permissions or their browser doesn't support it — all products are shown by default. The filter only activates when a zip/pin code can be confirmed.
  • Can I set different radii for different warehouses?
    Yes. Each warehouse has its own radius setting. A warehouse in a dense urban area might have a 5 km radius while a warehouse in a rural area might have a 50 km radius. Each is configured independently.
  • Can a single product be linked to multiple warehouses with different radii?
    Yes. If a product is stocked in more than one warehouse, it appears to any customer whose zip/pin code is covered by any of those warehouses.
  • Does the radius setting work with both zip codes and pin codes?
    Yes. Fetch PIN/ZIP retrieves the appropriate code format based on the country settings of your Shopify store.
  • Products aren't being filtered on the storefront even after setup.
    The most common cause is that the Collection Hyperlocal App Embed hasn't been saved in the theme editor, or that the Shipturtle team's backend configuration hasn't been completed yet. Confirm both before investigating further. If both are done, contact team@shipturtle.com with your store URL.
  • Fetch PIN/ZIP returned no results or very few zip codes.
    Check that the serviceable radius is set to a realistic value for the warehouse's location. A radius that's too small (e.g. 1 km in a rural area) may return no populated zip codes. Also confirm the warehouse address is correct — Shipturtle calculates the radius from the warehouse's saved address.
  • A customer says they can't see any products even though their location should be covered.
    Open the relevant warehouse in Merchant Profile → Warehouse and check the fetched zip/pin code list. Confirm the customer's zip/pin code appears in it. If it doesn't, increase the radius slightly and re-fetch.
  • A vendor's products aren't appearing for customers in their delivery zone.
    Check that the vendor has completed the serviceable radius setup on their warehouse. If the radius is set but the products are still not showing, confirm the products are correctly assigned to that warehouse in the vendor's product settings.

Related Articles

Need Help?

If you're stuck, contact the Shipturtle support team at team@shipturtle.com or raise a support ticket through the Shipturtle support page.