Skip to main content

Configure the Location search field

The Location field establishes latitude and longitude for radius filtering, distance sorting, map centering, and dynamic distance values.

Add the field​

  1. Open Builder → Search form.
  2. Add a field and set Type to Text.
  3. Enter a label such as Location and placeholder such as Enter a city or postcode.
  4. Set Search parameter to Location (geocode address).
  5. Set its desktop and mobile widths.

Add the attached “use my location” action​

Enable Show “use my location” action. This places a location icon attached to the address field. Selecting it requests browser geolocation and uses returned coordinates as the search origin.

This is different from adding the standalone “Use my location” button field; both trigger geolocation, but one is visually attached to the Location input.

Enable address autocomplete​

Enable Address autocomplete (Google) on the field. It requires:

  • Settings → Search → Address autocomplete enabled;
  • a valid Settings → Map → Google Maps API key (browser);
  • Google Places enabled for that key.

Under Restrict to country, enter comma-separated ISO-2 codes such as US or US,CA. Leave it empty to inherit Settings → Search → Restrict search to country; if both are empty, suggestions are worldwide.

Verify the result​

Embed the Layout containing this Search form and test while logged out:

  1. type an address and choose an autocomplete suggestion;
  2. confirm the request contains latitude and longitude;
  3. change Distance/radius and confirm coordinates remain present;
  4. use the attached location action and allow permission;
  5. deny permission in another private session and confirm address search remains usable.