How to Add a Store Finder Plugin to WordPress (No Coding Needed)


Adding a store locator to your WordPress site doesn’t have to be complicated. In this quick guide, you’ll learn how to install and set up the WordPress store finder plugin - no coding required, just a few simple steps to get your map live and working smoothly.

Option 1: The Best & Fastest Way - Use the MapCosmos Plugin

If you want the quickest and easiest setup, the best option is to install the store locator for WordPress by downloading the MapCosmos plugin from our website.
This method is fast, simple, and doesn’t require any embed codes — your map will be ready to go in just a few minutes.

Here’s how:

1. In your WordPress dashboard, just head to the left menu, click on ‘Add plugin,’ and then hit ‘Upload plugin’.
2. Upload the ZIP file of the WordPress store finder plugin to install it.
3. After activating the plugin, go to the page where you want to display your store locator wp.
4. In the page builder, select the Store Locator element and drag it to the right place on your page.
5. Finally, paste the installation code and save your changes.

Learn more about our store locator for WordPress.

‍

👉 download the MapCosmos plugin from our website.

Option 2: Get Your Store Locator Installation Code

Before you can add the map to your WordPress site, you must first configure your locator and generate a unique installation code from your MapCosmos account. This involves setting up your locations, customizing the map's appearance to match your brand, and adding any custom details you need.

👉 We’ve prepared a detailed guide on how to set up your widget and generate your installation code  - making it easy to launch your WordPress store finder plugin in minutes.

Add the widget to a WordPress Page

You can display your store locator for WordPress on any page by embedding the installation code using a Custom HTML block.

1. In your WordPress dashboard, go to Pages → Add New (or choose an existing page).
2. In the WordPress editor, click the “+” (Add block) icon to open the block library.
3. Search for Custom HTML and add it to your page.
4. Paste the embed code you copied from your MapCosmos account directly into the Custom HTML block.
5. Click Publish to make your store locator wp live on your website.

That’s it! 🚀

Do you have any questions about connecting to our powerful API for unique optimizations? Contact our team at contact@mapcosmos.com. We’re happy to help you get the most out of your WordPress store finder plugin.

🧩 Common Errors When Installing a Store Locator Plugin

Even with a simple setup, users sometimes encounter issues when adding their store locator for WordPress. Below are the most common errors — and how to fix them quickly.

1. Using the Wrong Embed Block

Many users paste their embed code into a “Text” or “Paragraph” block instead of the correct one.
✅ Fix: Use the Custom HTML block or your page builder’s Code/HTML element to paste the embed code properly.

2. Missing or Invalid API Key

A missing or incorrectly configured Google Maps or Mapbox API key can stop your map from loading.
✅ Fix: Double-check your API key is active, unrestricted, and entered exactly as provided.

3. Plugin Conflicts

Some caching, performance, or JavaScript optimization plugins interfere with your store locator WP functionality.
✅ Fix: Exclude the map page from caching or disable conflicting optimization plugins temporarily.

4. Theme or JavaScript Conflicts

Certain WordPress themes block or delay external scripts, causing your map not to load.
✅ Fix: Test using a default theme (like Twenty Twenty-Four). If it works, contact your theme developer or MapCosmos support.

5. Incorrect Shortcode Placement

Placing your shortcode inside a block that strips or escapes JavaScript will break your map.
✅ Fix: Always insert your shortcode or embed code directly into a Code or Custom HTML block.

💡 Tip: Using MapCosmos eliminates most of these issues automatically — it’s designed to work seamlessly with all modern WordPress themes and page builders.

👉 Need more help? Read our full guide on Troubleshooting WordPress Store Locator Issues for advanced fixes and diagnostics.