Docs / Guides / How to Link to Your Locator with a Pre-Filled Search

How to Link to Your Locator with a Pre-Filled Search

Pre-fill your store locator with a search query, tag filter, or specific location using URL parameters. Useful for CTAs, email campaigns, ads, and landing pages.

You can link directly to your locator with a search already filled in or a filter pre-selected. Useful for regional CTAs, filtered landing pages, email campaigns, or any link where you want visitors to land on specific results.

All you do is add a few extra characters to your locator URL.

Before You Start

You'll need a Storepoint account with your store locator already embedded on a page. If you're new, follow the Quick Start Guide to get set up.

Start Your Free Trial


Add ?locate= followed by a city, zip code, or any searchable location to your locator page URL. When someone clicks the link, the locator searches that area and shows nearby results.

Example:

If your locator page is at https://example.com/locations, link to:

https://example.com/locations?locate=90210

The locator searches that area and shows nearby results, just like a visitor had typed it into the search bar.

More Examples

https://example.com/locations?locate=Chicago
https://example.com/locations?locate=New York, NY
https://example.com/locations?locate=London, UK
https://example.com/locations?locate=Ontario, Canada

City names, zip codes, postal codes, states, countries. Whatever works in your locator's search bar works here.


Add ?tags= followed by a tag name to show only locations with that tag. This is useful when you want to link to a specific category of locations.

Example:

https://example.com/locations?tags=Authorized Dealer

The locator opens with the "Authorized Dealer" filter already applied.

Multiple Tags

Separate multiple tags with commas:

https://example.com/locations?tags=Authorized Dealer,Service Center

Or use the array format:

https://example.com/locations?tags[]=Authorized Dealer&tags[]=Service Center

Both formats work the same way.

Tip

Use your tag names exactly as they appear in your dashboard. If a tag has spaces, most browsers will encode them automatically when the link is clicked.


Combine Search and Filters

Use both parameters together to link to a filtered search in a specific area:

https://example.com/locations?locate=Austin&tags=Service Center

This searches for locations near Austin and only shows those tagged as "Service Center".


Set a Search Radius

Add ?distance= to set the initial search radius in miles (or kilometers if your locator uses metric):

https://example.com/locations?locate=Seattle&distance=50

This searches Seattle within a 50-mile radius.


Use Cases

Here are common ways to use these links:

Homepage CTAs

Create regional buttons that link directly to locations in each area:

  • "Find a Store in California" → ?locate=California
  • "View New York Locations" → ?locate=New York
  • "Dealers Near You in Texas" → ?locate=Texas

Email Campaigns

Include pre-searched links in newsletters targeting specific regions:

"Find your nearest location in Miami" → links to ?locate=Miami

Landing Pages

Create product-specific landing pages that link to filtered locator results:

  • "Find a Certified Installer" → ?tags=Certified Installer
  • "Premium Dealers Near You" → ?tags=Premium Dealer

Footer Links

Add quick links to popular cities:

  • Los Angeles → ?locate=Los Angeles
  • New York → ?locate=New York
  • Chicago → ?locate=Chicago

Quick Reference

Parameter What It Does Example
locate Searches a location ?locate=Denver
tags Filters by tag(s) ?tags=Premium
distance Sets search radius ?distance=25

Combine them with &:

https://example.com/locations?locate=Boston&tags=Authorized Dealer&distance=30

Common Questions

Does this work with any website platform?

Yes. These are standard URL parameters. They work regardless of whether your site is on Shopify, WordPress, Squarespace, Webflow, or any other platform.

Do I need to change anything in my dashboard?

No. This works automatically with any Storepoint locator. No configuration needed.

What happens if the search finds no results?

The locator displays the same "no results" message it would show for any search with no nearby locations.

Can I use this with Google Ads or Facebook Ads?

Absolutely. Use these URLs as landing page destinations to send paid traffic directly to relevant location results.


Need a Search Form Instead?

If you want visitors to type their own location before going to the locator, check out the External Search Bar guide. It covers how to add a search input on your homepage or footer that submits to your locator page.


Learn More

Still have questions?

We're happy to help anytime.

Get in Touch

Ready to get started?

Create your store locator in minutes.