A store locator with no map key
Locator adds a searchable directory of your physical stores to WooCommerce. Add a name, address, phone and opening hours as a location, and the [locator] shortcode renders a clean list shoppers filter by city, postcode or name. No external API and no map key.
Works with
Shoppers cannot find where you are
Your store has physical locations, but an online shopper does not know which is nearest. Without a simple finder they have to dig through a contact page or call, and some just skip the visit.
- ✗ No single, searchable list of stores
- ✗ Shoppers cannot find the location nearest them
- ✗ Map finders need an API key and fees
- ✗ Store lists are hard to read on a phone
Locator shows every store in one place
- ✓ A searchable directory rendered by the [locator] shortcode
- ✓ Instant filtering by city, postcode and name
- ✓ Get-directions links from coordinates or the address
- ✓ No external API and no map key
What you get in the free version
Everything you need to help shoppers find your physical stores.
Managed locations
Each store is its own post under WooCommerce: address, city, postcode, country, phone, email, opening hours and optional coordinates.
[locator] shortcode
Render a searchable, accessible store directory on any page.
Instant filtering
Filter by city, postcode or store name in the browser — no data leaves the page.
List or grid
Choose a list or responsive grid layout in settings or with layout=grid on the shortcode.
Choose visible fields
Decide which details show on each card: address, hours, phone, email and a Get directions link.
Get directions
The link opens the visitor's map app using the store coordinates or postal address.
Accessible by design
An ARIA live region for result counts, keyboard support, focus-visible styles and screen-reader text.
Core Web Vitals friendly
Server-side rendering with no layout shift; assets load only on the page with the shortcode.
Up and running in three steps
Add your stores and publish the first directory.
Install
Activate Locator alongside WooCommerce.
Add stores
Under WooCommerce → Store Locations, add addresses, hours and optional coordinates.
Place the shortcode
Drop [locator] on a page and check filtering by city, postcode and name.
Who it is for
When you have physical locations — a simple directory without a map API key.
Physical chains
A handful or dozens of stores — one list shoppers filter by city.
- ✓ Filter by city
- ✓ List or grid
- ✓ Get directions
Click and collect
Show where orders can be picked up, with hours and phone on the card.
- ✓ Opening hours
- ✓ Phone and email
- ✓ Server-side render
Sites with no API costs
The directory works without a map key and without per-request fees.
- ✓ No API
- ✓ No tracking
- ✓ Lightweight front end
Need more? Locator PRO
FREE covers a searchable store directory. Locator Pro adds an interactive map, region grouping and bulk import.
- ✓ Interactive map with pins (planned)
- ✓ Region grouping for large directories (planned)
- ✓ Bulk import from CSV (planned)
Support and resources
Every plugin has its own documentation with setup walkthroughs. Bugs and questions go to the public GitHub repository for that plugin — we answer in the open.
Frequently asked questions
Does it require WooCommerce?
Yes. Locator registers under the WooCommerce menu and requires WooCommerce to be active.
Does it show a map?
The free version is a searchable list — no map key needed. Map embedding is planned for the Pro add-on.
Do I need a map API key?
No. Locator does not connect to any external API and needs no key.
Can I change the layout?
Yes — choose List or Grid in the settings, or pass layout=grid to the shortcode.
How does filtering work?
In the browser: typing a city, postcode or name filters the cards in place, and the result count is announced through an ARIA live region.
Does the list work without JavaScript?
Yes. Every location renders server-side, so the list shows even with JavaScript disabled.
Can I override the markup?
Yes. Copy templates/locator-list.php into your-theme/locator/locator-list.php.
How does Get directions work?
The link opens the visitor's map app using the store coordinates or its postal address.
Add a store locator to your shop
A searchable directory with filtering and directions links. The full FREE edition under GPL.
Read the docsFREE is a complete store directory — PRO adds an interactive map and bulk import (planned).