Free, open source

Locator

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.

Open source GPLv2
Open source, GPL licensed No account, no card No API, no map key

Works with

WooCommerceGutenbergStorefrontAstraGeneratePressKadence

See it in action

A searchable directory of physical stores with addresses, hours and phone
The same store directory on mobile
Choosing which fields show on cards and managing locations in the dashboard

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
  • Phone shown as a click-to-call link on mobile
  • 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.

Clean card list

Locations are rendered server-side as a clean card list, with no layout shift.

Choose visible fields

Decide which details show on each card: address, opening hours and phone. The store name is always shown.

Click-to-call phone

The phone renders as a tel: click-to-call link on mobile.

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.

01

Install

Activate Locator alongside WooCommerce.

02

Add stores

Under WooCommerce → Store Locations, add addresses, hours and optional coordinates.

03

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
  • Live filtering
  • Click-to-call phone

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

What PRO adds, and why it matters

Interactive map

An embedded map with pins for every geocoded location via [locator_map], built on OpenStreetMap tiles.

Region grouping

Group [locator] list entries by a Region (Pro) field, with country fallback for unlabelled stores.

Bulk import

Import or update locations from CSV on WooCommerce → Store Locator Import instead of adding each store by hand.

What you get: FREE vs PRO

PRO keeps everything in the free plugin and adds the modules below.

Feature FREE PRO
Store directory ([locator] shortcode)
Client-side filtering
Locations as a post type
Toggleable fields: address, hours, phone
Accessibility (ARIA live, keyboard)
Works without JavaScript
Per-location lat/lng coordinates
Interactive map ([locator_map]) ×
Key-free OpenStreetMap tiles ×

Locator vs WP Store Locator vs Store Locator Plus

How Locator compares to the popular WooCommerce store locator plugins.

LocatorWP Store LocatorStore Locator Plus
Free version YesYesYes
Shortcode embed YesYesYes
Instant filtering YesYesYes
Choose visible fields Yes
Interactive map ProYesYes
Bulk import ProYesYes
Open source (GPLv2) YesCore GPLCore GPL
Paid plan price from €29/yr$59 one-time (Pro)Free + paid add-ons

Competitor data and pricing as of June 2026; check the vendors' sites for current pricing.

Need more? Locator PRO

FREE covers a searchable store directory. Locator Pro adds an interactive map, region grouping and CSV bulk import.

  • Interactive map [locator_map] (shipped)
  • Region grouping for large directories (shipped)
  • Bulk import from CSV (shipped)

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 as a WooCommerce submenu and requires WooCommerce to be active. Store locations are managed under WooCommerce → Store Locations. Without WooCommerce active, the plugin does not boot.

Does it show a map?

The free version renders a searchable list of cards, not a map, so it needs no map key or external service. You can still store latitude and longitude for each location. An interactive [locator_map] view on OpenStreetMap tiles is added by the paid Locator Pro add-on.

Do I need a map API key?

No. Locator does not connect to any external API and needs no key. It sends no HTTP requests and loads no third-party scripts, so your store data never leaves your site.

How does filtering work?

Filtering happens in the browser: typing a name, address, city, postcode or country shows and hides cards in place, with no network requests. The number of matching results is announced through an ARIA live region. You can turn the search box off in settings if you list only a few stores.

Does the list work without JavaScript?

Yes. Every location is rendered server-side, so the full list is visible even with JavaScript disabled. When JavaScript runs, it only adds live filtering in the search box. The stylesheet and script load only on the page where the shortcode is used.

Which fields does a store card show?

The store name is always shown. In settings you can enable address, opening hours and phone, and each field appears only when that location has a value. The phone renders as a tel: click-to-call link on mobile.

Can I override the markup?

Yes. Copy templates/locator-list.php from the plugin into your-theme/locator/locator-list.php and edit the theme copy. The plugin looks for the template in the active theme first, so your version survives updates.

How does Locator compare to WP Store Locator and Store Locator Plus?

Locator ships a fast, Core Web Vitals friendly store list with shortcode embed, instant filtering and selectable fields for free, then adds an interactive map and bulk import in the paid edition from €29/yr. WP Store Locator is free with a one-time $59 Pro, and Store Locator Plus is free with paid add-ons, both leading with map output by default. Pricing as of June 2026.

Add a store locator to your shop

A searchable directory with filtering and click-to-call phone. The full FREE edition under GPL.

Read the docs

FREE is a complete store directory, PRO adds an interactive [locator_map], region grouping and bulk CSV import.