Search filters let your visitors narrow down locations by category. Think "Drive-Through", "Open 24 Hours", "Organic", or whatever makes sense for your business. They show up as clickable options in your store locator widget, and visitors can pick one or more to find exactly what they need.

Filters are one of the most-used features in StoreRocket, and they only take a few minutes to set up.

That's it. Your filter exists now, but it won't show up in the widget until you assign it to at least one location.

Creating a filter is step one. Step two is telling StoreRocket which locations have which filters. You have three ways to do this.

Go to Locations, edit a location, scroll down to the Filters section, check the filters that apply, and save. Simple, but slow if you have hundreds of locations.

This is the fastest way to assign filters in bulk. When you import locations via CSV, add a column called Filters to your spreadsheet. For each location, list the filter names separated by commas.

This is the #1 thing people get wrong. Read this section carefully.

Your CSV column header must be exactly: Filters

Not Filter. Not filter. Not Category. Not Tags. Just Filters with a capital F.

Inside each cell, list the filter names separated by commas:

Here's a full CSV example:

Important details about the Filters column:

Same format as CSV. Add a Filters column to your connected spreadsheet, use comma-separated filter names, and StoreRocket will pick them up on the next sync. Set up your Google Sheet at the Spreadsheet page.

When a visitor selects multiple filters, you control what happens. Go to Widget > Settings and find the Filters Behavior section.

You'll see two options:

"Show locations that have ALL the selected filters" (AND logic)

This is the default. It's strict. If a visitor selects "Parking" and "WiFi", they'll only see locations that have both Parking AND WiFi. If a location only has Parking, it won't show up.

This works great when your filters are attributes or features. Visitors are saying "I need a location with ALL of these things."

"Show locations that have ANY of the selected filters" (OR logic)

This is more relaxed. If a visitor selects "Organic" and "Drive-Through", they'll see all locations that have Organic, all locations that have Drive-Through, and all locations that have both.

This works great when your filters are categories or brands. Visitors are saying "I'm interested in ANY of these types."

Getting zero results after selecting filters? You're probably using AND logic and no locations have all the selected filters assigned. Either switch to OR logic or make sure your locations have the right combinations of filters.

This is powerful. You can make different pages on your website show different subsets of your locations, all from the same StoreRocket project.

Add data-storerocket-filters to your embed code to load the widget with certain filters already selected:

The values are filter IDs (not names). You can find each filter's ID on your Filters page, shown next to each filter name.

For multiple filters, separate IDs with commas: data-storerocket-filters="42,78,103"

Visitors can still clear these filters to see all locations.

If you only want certain filters to be available on a specific page, use data-storerocket-enabled-filters:

This hides all other filters from the dropdown. Only filters with IDs 42 and 78 will be visible and selectable. This is different from pre-selecting: it completely removes the other filters from the widget on that page.

You can combine them. This loads the widget with filter 42 already selected, and only filters 42 and 78 available in the dropdown:

Get your base embed code from the Install page and add these attributes to it.

Don't want your widget to say "Filters"? No problem. Go to your Languages page, find the field labeled Filters Label, and change it to whatever you want. "Brands", "Categories", "Services", "Store Type", whatever fits your business.

The change shows up on your live widget within a minute.

Want to keep a filter for internal organization but hide it from visitors? Edit the filter on your Filters page and toggle Visible off.

Hidden filters still work with pre-filtered embeds (using data-storerocket-filters). They just won't show up as options visitors can click on.

You can replace the default colored dots with custom icons. Edit any filter on your Filters page and upload an icon. Accepted formats are JPG, PNG, or SVG, up to 1MB.

To show the icons in your widget (instead of colored dots), go to Widget > Settings and enable the Use filter icons option.

The most common reason: no locations have that filter assigned. Creating a filter doesn't do anything by itself. You need to assign it to at least one location, either through the dashboard, CSV import, or Google Sheets.

Also double-check that the filter is set to Visible on your Filters page.

Browser cache. Try a hard refresh (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac). If your website uses a CDN or caching plugin, clear that cache too. Give it a minute or two.

Check your CSV column header. It must be exactly Filters (capital F, plural). If you used Filter, filters, Category, or anything else, the import won't pick it up as filters.

Also make sure the filter names in your CSV cells match exactly what's in your StoreRocket account (or they'll be created as new, separate filters).

This is expected. Creating a filter is just step one. You need to go to each location and check that filter, or assign filters via CSV/Sheets import. A filter with zero locations assigned to it won't appear in the widget.

You're using AND logic (the default). No locations in the visible area have ALL the selected filters. Either switch to OR logic in Widget > Settings, or make sure your locations actually have the right filter combinations.

Make sure you're using filter IDs (numbers), not filter names. The data-storerocket-filters and data-storerocket-enabled-filters attributes expect numeric IDs, which you can find on your Filters page.

Questions about filters? Hit us up on live chat.