Keyword Search

Keyword Search adds a fast keyword field so visitors can filter locations by text — on the map chrome or as a standalone field elsewhere on the page.

This is an Ultimate module. Enable under Ultimate Modules.

When to use it

  • Directories where users know a name (“Hilton”, “Blue Bottle”)
  • Pairing with faceted filters for “type + keyword”
  • Header/hero search that targets a map further down the page

For full multi-field forms with redirect, use Advanced Search. For taxonomy chips on the map, see core faceted search or Markers Filter.

Enable on a map

  1. Enable the module globally.
  2. Edit the map → open Keyword Search settings.
  3. Add keyword search to the map (option Yes).
  4. Optionally open the keyword form automatically on map load.
  5. Customize placeholder text and search button icon.
  6. Update the map.

Suggest keywords

You can configure suggested keywords to guide visitors (popular areas, brand names, categories-as-text). Suggestions reduce empty searches and help on mobile keyboards.

Keep suggestions short and actually matching real content in your query population.

Shortcode: field outside the map

Display the keyword field anywhere:

[cspm_keyword_search]

Use this in a hero, sidebar, or sticky header. Wire it to the intended map instance via the attributes your build supports (map id / target) — see the shortcode reference under Shortcodes.

Design tip

If the field sits far from the map, scroll the user to the map on submit (theme JS or built-in behaviour if available) so results are obvious.

Placeholder & icon

  • Placeholder — e.g. “Search by name or city…”
  • Button icon — match Customize / brand icons

How it interacts with other filters

Keyword search usually combines with whatever else is active (facets, Markers Filter, Draw a Search). Order of application can matter for UX: test “keyword then facet” and “facet then keyword” on a busy map.

Troubleshooting

Issue Check
No keyword UI Module off; not enabled on this map
Shortcode does nothing Wrong attributes; JS error; cache
No matches for known titles Query excludes those posts; searching fields that don’t include titles in your config
Conflicts Old standalone Keyword Search plugin still active

Related

Top