Location Search

Updated

Usage

The Location Search block is a store locator. Visitors enter a US zip code and a distance in miles, then see nearby locations on a map and as result cards, with optional address, contact details, and links.

Turn on Enable Mapping and pick a map provider in the Customizer first.

Settings

  • Columns — result cards per row
  • Title Link — link each result's name to its page or its spot on the map
  • Show Address / Show Contact / Show Locate Link / Show Details Link
  • Default Location — where the map centers before a search
  • Initial Load Results — how many locations show before a search
  • Background / Reverse Print — card colors

Tips

  • On a busy locator, raise Locator Query Cache and Locator HTML Cache in the Customizer to speed up searches.
  • If visitors don't need to search by distance, a Locations block is simpler.

Settings

Columns setting in the block editor sidebar
Columns

Result cards per row.

  • 1
  • 2default
  • 3
Show Address setting in the block editor sidebar
Show Address
Show Contact setting in the block editor sidebar
Show Contact

Shows phone and email on each result.

Default Location setting in the block editor sidebar
Default Location

Where the map centers before anyone searches.

Intial Load Results setting in the block editor sidebar
Intial Load Results

How many locations show before anyone searches.

What to Display setting in the block editor sidebar
What to Display

Search every location, or only certain Regions or Types.

  • Show All Locations
  • By Region
  • By Type
Type setting in the block editor sidebar
TypeShown when What to Display is set to By Type.

Appears when What to Display is By Type.

Region setting in the block editor sidebar
RegionOnly appears when What to Display is By Region.

Appears when What to Display is By Region.

Background setting in the block editor sidebar
Background

Background color for the result cards (default gray).

  • <span class="dashicons_swatch white"></span>
  • <span class="dashicons_swatch gray"></span>default
  • <span class="dashicons_swatch dark"></span>
  • <span class="dashicons_swatch primary"></span>
  • <span class="dashicons_swatch secondary"></span>
  • <span class="dashicons_swatch accent"></span>
  • <span class="dashicons_swatch variant"></span>
Reverse Print setting in the block editor sidebar
Reverse Print

Light text for dark backgrounds.