The map does not show, only the list
The map shows only when at least one store has a place. Open the Stores panel: stores marked Not on the map have no latitude and longitude yet. Press Find on map in each store, or Find the places of … stores for all of them.
If the stores have places and the map is still missing, open the browser console (F12) and look for an error that names SoftIcon Store Locator. The list always stays, so visitors can still read your stores.
The map is grey, or the tiles say the access is blocked
OpenStreetMap’s tile server needs to know which site asks for its tiles. If a security plugin or your server sends the header Referrer-Policy: no-referrer, the tiles are refused. Use strict-origin-when-cross-origin (the browser’s default) instead.
A very busy site can also be limited by OpenStreetMap. Set another tile server in the Map panel (see “Use another map tile server”).
A store’s pin is in the wrong place
The free place search is not perfect, especially for new streets and in some countries. Open the store and drag its orange pin to the right spot, or type its Latitude and Longitude. Stores found without their postcode are marked Check the pin in the list.
“This address was not found” or “The map service did not answer”
Check the spelling of the street and the town, and fill in the country. You can also click the map where the store is. “The map service did not answer” means OpenStreetMap’s search did not reply; wait a minute and try again. It allows about one request a second, so the button waits between stores.
The Near me button is missing
Browsers give a location only to sites on https, so the button shows only there. It is also hidden when no store has a place on the map, or when Near me button is off in the Search panel. If a visitor blocked location for your site, they see “Your location could not be found. Type your town or postcode instead.”
A search says “Nothing was found”
No store matched the words, and the place could not be looked up. If Look up other places is off in the Search panel, only your stores’ own details are searched, so a town without a store finds nothing. Turn it on to sort the stores by distance from any town or postcode.
My CSV file cannot be read, or accents look wrong
The first row must hold the column names. In Excel, save the sheet as CSV UTF-8; a plain “CSV” file loses accents such as é and ü. Rows without a name, an address and a town are skipped, and a block takes up to 500 stores.
An email address or website does not show
The page shows only valid addresses. An email must be a plain address such as shop@example.com (no accented letters), and a website must be a web address. The store form says “Not shown on the page: this is not a valid address.” under a field that will not show.
My tile server does not work
The address must start with https:// and contain {z}, {x} and {y}, for example https://tiles.example.com/{z}/{x}/{y}.png. Otherwise the panel shows a warning and the map uses OpenStreetMap. Some providers also need a key in the address and a list of the sites allowed to use it.
The block is in a popup or a tab
That works: the map sizes itself when the popup or tab opens. If a popup adds the block to the page later with JavaScript, ask it to run document.dispatchEvent( new Event( 'alsl:boot' ) ) after it opens.
I use a caching or optimization plugin
That is fine. The block makes no AJAX calls, and it finds its own files even when an optimization plugin combines or moves its scripts. The map’s code loads only on pages with the block.
I use the Classic Editor or a page builder
Store Locator is a block, so you add it in the block editor. With the Classic Editor plugin, edit the page with the block editor instead.
Something else is wrong
Ask in the support forum or email softiconai@gmail.com. Tell us your WordPress version, the page with the store locator and what you see.