How to Add a Store Locator to WordPress

The quickest ways onto a WordPress page are the free StoreRocket plugin, which adds the locator as a block or with the [wp-storerocket] shortcode, or one embed code pasted into a Custom HTML block. Either way your locations are managed in StoreRocket, not in your WordPress database.

We make StoreRocket, so weigh our view with that in mind. This guide also covers WordPress plugins, custom code and hosted embeds, so you can pick the right one and create your locator only if it fits.

Related: Best store locator for WordPress | What is a store locator?

The short answer

Only a few locations and no budget? You may not need a store locator at all. A free embedded map with a pin for each location is fine when the list is short, rarely changes and visitors only need to see where you are. Our guide to free store locator options compares them.

The 3 Ways to Add a Store Locator to WordPress

Option 1: WordPress Plugins (Free & Paid)

The most common approach. Install a plugin, configure settings, add locations.

Pros:

• No coding required
• Lives within WordPress

Cons:

• Limited features on free tiers

Option 2: Custom Code (DIY)

Build it yourself with Google Maps or Mapbox APIs.

Pros:

• Complete control
• No recurring costs (except API)
• Tailored to your needs

Cons:

• Requires development skills
• Ongoing maintenance

Option 3: Hosted Solutions (Embed or Plugin)

Use a dedicated store locator service and show it on your site with an embed code or a plugin.

Pros:

• Hosted location management
• Product support
• Analytics options

Cons:

• Monthly subscription
• Data hosted externally

Let's explore each option in detail.

Option 1: WordPress Store Locator Plugins

Top Free Plugins

WP Store Locator

A free option available from the WordPress plugin repository.

Features:

• OpenStreetMap (no API key), Stadia Maps, Mapbox or Google Maps
• Search by radius
• Category filters
• Opening hours with an Open now badge

Setup:

1. Install via Plugins > Add New > Search "WP Store Locator"
2. Activate the plugin
3. Pick a map provider: OpenStreetMap needs no key; for Google Maps, enter your Google Maps API key
4. Add locations manually
5. Use shortcode [wpsl] on any page

Store Locator Plus

Another popular choice with a freemium model.

Features:

• Google Maps support
• CSV import
• Shortcode embedding
• Basic search

Paid Plugin Options

Jetstash Store Locator

Features:

• Multiple map providers
• Analytics dashboard
• Custom fields
• Filters and categories

Limitations:

• Uses map-provider API keys

WP Multi Store Locator Pro

Features:

• Unlimited locations
• Multiple maps per site
• CSV import/export
• Radius search

Option 2: Custom Code (Building from Scratch)

Want complete control? A custom build is a real project, not a snippet. It needs:

• Hosting you maintain, plus a Google Maps or Mapbox API account and key
• A place to store locations and a screen for your team to edit them
• Geocoding, so every address becomes a pin
• Distance search and sorting, with a results list and filters
• A phone layout, and testing on the themes and plugins your site really uses
• Ongoing fixes when a map API, a browser or a WordPress update changes something

Our guide to building a store locator with AI goes through each part and the checks to run before launch.

Option 3: Hosted Store Locator

With a hosted platform, you manage the locator outside WordPress and embed it on a page.

How Hosted Store Locators Work

1. Sign up for a store locator service
2. Add your locations (or import via CSV/Google Sheets)
3. Customize the appearance
4. Copy the embed code
5. Paste into WordPress
6. Done

The map loads from the service's servers, and location updates do not require editing WordPress.

Why StoreRocket for WordPress

StoreRocket is purpose-built for this use case:

WordPress integration:

• A free plugin on WordPress.org adds the locator with a block or a shortcode
• The embed code also works without the plugin, in any editor or page builder that accepts custom HTML

Features:

• ✅ Google Maps AND Mapbox support
• ✅ Daily Google Sheets sync (depends on the plan)
• ✅ Analytics and heatmaps (depends on the plan)
• ✅ Lead capture forms (depends on the plan)
• ✅ Customization controls
• ✅ REST API (depends on the plan; see StoreRocket's current plans)

Adding StoreRocket to WordPress

Step 1: Sign up for StoreRocket

Visit storerocket.io and start a free trial, no credit card needed.

Step 2: Add your locations

Choose your method:

• Manual entry: Add locations one by one and place each pin on the map
• CSV import: Upload a spreadsheet of your locations
• Google Sheets sync: Create a linked spreadsheet from StoreRocket's dashboard for daily sync (depends on the plan). Follow the Google Sheets setup guide

Step 3: Customize your map

• Choose a theme
• Select map provider (Google Maps or Mapbox)
• Match your brand colors
• Configure search radius
• Set up filters

Step 4: Get your embed code

Go to the Install page and copy the embed code shown for your account. It is a short block with your account ID already in place, so paste it exactly as copied rather than retyping it.

Step 5: Add to WordPress

With the free StoreRocket plugin (block or shortcode):

1. Go to Plugins > Add New and search for "StoreRocket"
2. Install and activate the free StoreRocket Store Locator plugin
3. In the plugin's settings, paste the install code from your StoreRocket Install page.
4. On the page, add the StoreRocket Store Locator block, or type the [wp-storerocket] shortcode
5. Publish

With Gutenberg (Block Editor), no plugin:

1. Edit your page
2. Add a "Custom HTML" block
3. Paste the embed code
4. Publish

With Elementor:

1. Edit with Elementor
2. Drag in an "HTML" widget
3. Paste the embed code
4. Update

With Classic Editor:

1. Edit your page
2. Switch to "Text" tab (not Visual)
3. Paste the embed code
4. Update

Preview the published page, not only the editor, then add it to your menu.

After install, you change locations in the StoreRocket dashboard and the locator on your page updates itself. StoreRocket maintains the hosted locator and delivers updates through the embed already on your site.

Troubleshooting on WordPress

The shortcode shows as plain text. Check that the plugin is active, and that the shortcode sits in a Shortcode block or an ordinary paragraph. A Code or Preformatted block prints it as text.

The locator does not appear after pasting the embed code. Check that the whole snippet was pasted into a Custom HTML block or an HTML widget, and that the page is published. WordPress removes scripts from the content of users without the unfiltered HTML capability, so try again as an Administrator.

It works for you but not for visitors, or only after a refresh. A caching or minify plugin may be serving an old page or reworking the script. Clear the cache after publishing. If the locator still fails, turn off the plugin's JavaScript minify, combine or delay options one at a time, and exclude the StoreRocket script if one of them is the cause.

It looks wrong inside a page builder. Judge the published page, because builder previews can block third-party scripts. Give the locator's container the full column width, and check that no fixed height or hidden overflow on a parent cuts it off.

If none of these fixes it, check the browser console for the exact error and send it to support.

Comparison: Which Option is Right for You?

Choose Custom Code If:

• You have unique requirements
• You have developer resources
• You want complete control
• You can maintain it long-term

Choose a WordPress plugin if:

• You have a short list that rarely changes
• You want locations inside WordPress
• You are happy to manage the Google Maps key and plugin updates

Choose StoreRocket If:

• You need analytics or lead capture
• You want daily Google Sheets sync
• You prefer hosted location management

Frequently Asked Questions

Do I need a Google Maps API key for WordPress store locators?

Check the selected plugin's current documentation. After the free trial, StoreRocket customers connect their own Google Maps or Mapbox key, while StoreRocket handles import geocoding and hosts the locator application.

Will a store locator slow down my WordPress site?

StoreRocket runs on pages where you embed it and does not query the WordPress database. Measure the page with your production theme and plugins.

Can I import locations from a spreadsheet?

Yes. StoreRocket imports CSV, TSV, TXT, XLS or XLSX files on every plan, and Google Sheets sync, on demand or once a day, depends on the plan. For a plugin, check its own import documentation.

How many locations can I have?

Plugin limits vary. StoreRocket plans are sized by the number of locations; see current plans.

Is it SEO-friendly?

Learn more about the broader strategy in our Store Locator SEO Guide.

Can I capture leads from my store locator?

Depending on the plan, StoreRocket shows a lead form when a search finds no location nearby, saves the lead in your dashboard and emails your team. Check other products' current documentation for their published lead workflows.

Get Your Store Locator Live

To install StoreRocket:

1. Sign up for StoreRocket (free trial, no credit card)
2. Import your locations
3. Add the free plugin's block, or paste the embed code into a Custom HTML block
4. Publish the page

Connect your own map key when you subscribe. No developer required.

Create your locator →

Questions about adding a store locator to your WordPress site? Contact our team, we're here to help.