The Search Type setting in WP Maps defines how users can search for locations using the map’s search bar. Whether your users are entering full addresses or just city names, this setting ensures they get accurate and responsive search results.
Currently, WP Maps provides two primary options under this setting: Address Typeahead and Geocoder Only.
Each option affects the way the map interprets and processes user input, offering flexibility based on your business needs and preferred map provider (Google or Mapbox).
What the Options Do #
Let’s explore the functionality of each option:
1. Address Typeahead #
- As users begin typing an address, this option offers live suggestions in real time.
- Powered by either Google Places API or Mapbox Geocoding API (based on your selected map type).
- This creates a smooth and guided search experience, reducing user input errors and speeding up location selection.
- Best suited for customer-facing sites where ease of use is critical.

2. Geocoder Only #
- Skips suggestion prompts and relies on full user input before triggering a search.
- Uses backend geocoding services to find and interpret the provided address or location.
- Useful for reducing API call volume or when you want to keep the search box simple and lightweight.
- It can be better suited for internal tools or controlled environments where users know exactly what to enter.

Use Cases and Benefits #
Both options offer distinct benefits depending on your application:
- Address Typeahead improves usability and reduces typing errors, which is ideal for public maps, e-commerce store finders, and mobile users.
- Geocoder Only minimizes distractions and conserves API call limits, which is ideal when simplicity or performance is a concern.
By tailoring the search experience, you ensure that your users always find what they’re looking for—whether that’s the nearest store or a specific delivery zone.
How to Configure #
To change the Search Type:
- Log in to your WP Maps account and click on the “Widgets” tab.
- Click on “Install Widget”.
- Under the “Map Configuration” section, locate the Search Type dropdown.
- Choose between Address Typeahead or Geocoder Only based on your goals.
- Save your changes.
Note: The Address Typeahead feature relies on API integration with either Google or Mapbox, so ensure the correct API keys are set.
For any questions or concerns, feel free to contact us at [email protected].

