Location search lets visitors type an address, city, or zip code to find listings near that location. Results are sorted by distance, and listings appear on an interactive map.
How to Add Location Search
- Go to Widget Settings → Search & Filters
- Click Add → Location Search
- Set the placeholder text (e.g., "Search by city or zip code...")
- Set the max search radius
- Save your settings
Configuration Options
Placeholder text: the hint text in the search field.
Max search radius: the maximum distance from the searched location (in km or miles, based on your widget's distance unit setting).
Show icon: display a location icon in the search bar.
Requirements
Location search needs a few things set up first:
-
Listings need addresses: each listing you want searchable by location must have an address. Listings without addresses won't appear in location-based results.
-
Mapbox integration: location search uses Mapbox for geocoding and map display. You'll need a Mapbox account and access token added in Map Settings. See the Map Features section of the setup guide.
-
One per widget: you can only add one location search per directory.
Location search works best alongside a search bar so visitors can search by keyword AND location at the same time.