A locator is an interactive map and search experience that helps visitors find the nearest location. Visitors can search by city, zip code, or current location, or explore by moving the map. Results appear as a list alongside the map — each location shows calls to action for Get Directions and View More Information, linking directly to the corresponding location page.
The locator is built into Yext Pages, so there's no need to configure a separate Search experience or involve a developer.
Note: The locator map is currently powered by Mapbox. Support for additional map providers is planned for future releases.
What Gets Created
When you generate a locator, the system automatically:
- Creates a pre-configured Yext Search experience optimized for location finding
- Creates a locator entity in the Knowledge Graph that powers the locator page
- Creates a locator page group
The locator search experience uses the same entity scope as its parent location page group — visitors can only find locations included in your page group. For example, if your page group includes only locations in New York City, the locator only shows those same locations.
Generate a Locator
The easiest time to add a locator is when you create a page group — the Generate Locator checkbox is selected by default. If you skipped it at setup, you can add one at any time.
To add a locator to an existing page group:
- Navigate to Pages > [Your Site] > Page Groups.
- Click the menu icon in the row of the page group you want to add a locator to.
- Select Create Locator.
- Confirm you want to create a locator.
After deployment, which may take a few minutes, a new locator page group appears on the Page Groups screen.
Customize the Locator
The locator page group functions like any other page group. Click Edit Layout to open the layout editor and preview the locator.
Map style: Click on the locator section in the layout editor and update the map style property in the right panel.
Facets: The locator comes pre-configured with facet fields appropriate for location filtering — amenities, services, hours, and similar fields. To control which facets are visible to visitors:
- Open the layout editor for the locator page group.
- Click on the locator component in the preview.
- Toggle facets on or off in the properties panel.
This lets you show only the filters most relevant to your visitors without modifying the underlying search configuration.
Preview and Test
Click Preview Changes in the layout editor to open the locator in a new tab and test the full search experience — map interaction, search by location, and the directions and detail links. Use View Live Site to check the published version.
Note: The locator links to your individual location pages. Make sure your location page group is published before directing visitors to the locator.