# Custom Search Filter

The Custom Search Filter will give the user an input box to type into, and using their text, it will search through the post titles and popup text you've added in order to present clickable results that will zoom to the relevant feature.

If you want, you can include a geocoder with this -- meaning that users will be able to search both the features you've added *and* real-world locations together. Your features will always appear first in the list if any match is found.

<figure><img src="/files/Gp7EPMXINAYhZzYYi2S0" alt=""><figcaption></figcaption></figure>

### Include Geocoder <sup><sub>*<mark style="color:blue;">\[Requires Mapbox access token]</mark>*<sub></sup>

Allow users to search both general address and your feature information at the same time.

* **Limit results** by country code (use [2-letter country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))
* **Modify the search placeholder text**

### Number of Results <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Adjust how many results are returned maximum

### Search Type <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

Adjust whether search results must find an exact match, match any term, or match all terms entered. [You can see examples here](https://wpmaps.mapster.me/examples/#controls-filters).

For instance, if you have three points, and they have the titles:

* Bear Lake Station
* Station Grudge Bear
* Lake Bear Station

And someone searches "Bear Lake", then:

* With Exact Matching, "Bear Lake Station" will show up
* With Any Term, all three will show up (all match "Bear")
* With All Terms, "Bear Lake Station" and "Lake Bear Station" will show up

### Embed on Separate Page <sup><sub>*<mark style="color:green;">\[Pro]</mark>*<sub></sup>

To make a unique landing page that users can use as a portal to search your map like on popular real estate websites like AirBNB, use the shortcode generated in this section.

You can then style the front-end search form to make it look how you want and have it direct users to specific popups, locations, or shapes on your map.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wpmaps-docs.mapster.me/maps/filters/custom-search-filter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.