# Store Locator > Searchable store locator map with filters and analytics Source: https://help.pasilobus.com/store-locator Shopify App Store: https://apps.shopify.com/pasilobus-store-locator (listed as "Pasilobus Store Locator") Price: Free plan · paid from $4.99/month Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Every article in one file: https://help.pasilobus.com/store-locator/llms-full.txt ## Getting started Install and set up Store Locator on your store - [Installation](https://help.pasilobus.com/store-locator/installation.md): Install Store Locator and complete the initial setup - [Adding locations](https://help.pasilobus.com/store-locator/adding-locations.md): Add store locations with address, contact info, business hours, and more - [Importing locations](https://help.pasilobus.com/store-locator/importing-locations.md): Bulk import locations from CSV files - [Plans & features](https://help.pasilobus.com/store-locator/plans-and-features.md): Compare Store Locator plans and see which features each one includes ## Features Configure your store locator and customize the display - [Map providers](https://help.pasilobus.com/store-locator/map-settings.md): Choose your map provider and set up your API key - [Languages & translations](https://help.pasilobus.com/store-locator/widget-customization.md): Translate the store locator into any language - [Location details](https://help.pasilobus.com/store-locator/location-details.md): Configure what information displays for each location - [Search & display settings](https://help.pasilobus.com/store-locator/search-and-filters.md): Configure search behavior, map display, and geolocation - [Theme integration](https://help.pasilobus.com/store-locator/theme-integration.md): Add Store Locator to your theme using the app block ## Troubleshooting Common issues and solutions - [Map not showing](https://help.pasilobus.com/store-locator/map-not-showing.md): Fix issues with the map not displaying - [Locations not appearing](https://help.pasilobus.com/store-locator/locations-not-appearing.md): Fix invisible store locations - [Import errors](https://help.pasilobus.com/store-locator/import-errors.md): Fix CSV import problems --- # Installation > Install Store Locator and complete the initial setup Source: https://help.pasilobus.com/store-locator/installation App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Getting started Last updated: 2026-02-20 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Installing from the App Store 1. Visit the [Store Locator](https://apps.shopify.com/pasilobus-store-locator) app listing on the Shopify App Store 2. Click **Add app** to begin the installation 3. Review the permissions and click **Install app** ## Adding Store Locator to Your Theme After installation, add the Store Locator app block to your theme. You can either create a dedicated store locator page or add the block to an existing page. The quickest way is the app's setup guide. Once your theme has a page template named `store-locator` (steps 1-4 below), **Add block in theme editor** opens that template with the Store Locator block already added in a new Apps section. Check where it sits, then click **Save**. ## Create a Dedicated Page The recommended approach is a dedicated page with its own template. Your other pages (About, Contact and so on) share the Default page template, so adding the block there would show the locator on all of them. 1. Go to **Online Store > Themes** and click **Customize** on your theme 2. In the template menu at the top of the editor, open **Pages** and click **Create template** 3. Name it `store-locator`, base it on **Default page**, and click **Create template** 4. In your Shopify admin, go to **Online Store > Pages** and click **Add page** 5. Enter a title such as "Store Locator" or "Find a Store", set **Theme template** to `store-locator`, and click **Save** 6. In the app's setup guide, pick the theme and click **Add block in theme editor** (or, in the theme editor, open the `store-locator` template, click **Add section** and select **Store Locator** under **Apps**) 7. Click **Save** ## Add to an Existing Page You can also add the store locator to any existing page: 1. Go to **Online Store > Themes** and click **Customize** 2. Navigate to the page where you want the store locator (e.g., Contact page) 3. Click **Add section** or **Add block** 4. Under **Apps**, select **Store Locator** 5. Position the block where you want it to appear 6. Click **Save** ## Add to Your Navigation Menu Make it easy for customers to find your store locator: 1. Go to **Online Store > Navigation** 2. Select the menu to edit (e.g., Main menu or Footer menu) 3. Click **Add menu item** 4. Enter a name like "Locations" or "Find a Store" 5. Link to the store locator page you created 6. Click **Save menu** ## Dashboard Overview The Store Locator dashboard gives you quick access to everything: - **Locations** - View, add, and manage your store locations - **Settings** - Configure map provider, appearance, and behavior - **Import** - Bulk import locations from CSV files - **Analytics** - Track how customers interact with your store locator ## Next Steps Once installed, you're ready to: 1. [Add your first location](https://help.pasilobus.com/getting-started/adding-locations) manually 2. Or [import locations in bulk](https://help.pasilobus.com/getting-started/importing-locations) from a CSV file 3. [Configure map settings](https://help.pasilobus.com/features/map-settings) to customize the display --- # Adding locations > Add store locations with address, contact info, business hours, and more Source: https://help.pasilobus.com/store-locator/adding-locations App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Getting started Last updated: 2026-02-18 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Creating a New Location 1. From the dashboard, click **Locations** in the navigation 2. Click **Add Location** 3. Fill in the location details 4. Click **Save** ## Address Enter your location's address in the provided fields: - **Address Line 1** - Street address (required) - **Address Line 2** - Suite, unit, or floor number - **City** - **State / Province** - **Postal Code** - **Country** The app automatically converts addresses to map coordinates. You can also use the address search box at the top of the form to quickly fill in all fields. ## Business Details Add contact information so customers can reach the location: - **Phone number** - Shown as a clickable link on mobile - **Email** - Opens the customer's email app - **Website** - Link to a location-specific page - **Notes** - Internal notes (shown to customers in the store locator) ## Logo Upload a logo or photo to help customers identify the location. ## Business Hours Set regular opening and closing times for each day of the week. Check **Closed** for days the location is not open. > Business hours and special hours are available on Growth plans and above. Social media links are available on Basic plans and above. ## Special Hours Add modified hours for holidays or special events. These override regular business hours on the specified date. ## Social Media Add links to the location's social media profiles (Instagram, Facebook, Twitter/X, TikTok, YouTube, LinkedIn). ## Image Gallery Upload up to 10 photos of the location. Images are displayed when customers view the location details. > The image gallery is available on the Premium plan. ## Custom Fields If you've created custom fields, fill in values for each location. Custom fields can include text, links, or toggles that act as filters on the storefront. ## Location Visibility Control whether a location appears on your store locator: - **Visible** - Shows on the map and in search results - **Hidden** - Saved but not displayed to customers Use hidden status for locations that are temporarily closed or not yet ready to publish. --- # Importing locations > Bulk import locations from CSV files Source: https://help.pasilobus.com/store-locator/importing-locations App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Getting started Last updated: 2026-01-21 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Import many locations at once from a CSV file: the fastest way to add a chain of stores or a stockist list kept in a spreadsheet. The same file format updates existing locations, and a file exported from the Locations page imports back as it is. ## Get the template On **Locations › Import**, click **Download sample template** for a ready-made file with every column filled in, and **View CSV format requirements** for the full column list, including your own custom fields. ## Columns Column order and capitalization don't matter; commas, semicolons and tabs all work as separators. - **name, address_line1, city, country** - Required. A row missing one of them is not imported, and the result lists it. - **address_line2, state, postal_code** - Optional address details. - **latitude, longitude** - Optional. Leave them blank and the address is looked up for you. - **phone, website, email, notes** - Optional contact details. An invalid email is dropped and the rest of the row still imports. - **visible** - `yes` or `no` (also `Visible` or `Hidden`). Hidden locations stay off the storefront map. - **instagram, facebook, twitter, tiktok, youtube, linkedin** - Social link URLs (Basic plan and above). - **hours** - Opening hours such as `Mon 09:00-17:00; Tue 09:00-17:00; Sat 10:00-14:00`. Days you leave out are marked closed (Growth plan and above). - **categories** - One or more categories separated by commas or semicolons; new ones are created (Growth plan and above). - **priority** - A whole number; higher ranks first (Advanced plan and above). - **Your custom fields** - A column named like the field (Growth plan and above). Columns your plan doesn't include are skipped, and the import result names them, so an import never adds features your storefront won't show. ## Importing 1. Go to **Locations** and click **Import** 2. Drop your CSV on the upload area, or click it to pick the file 3. Click **Import Locations** 4. Follow the progress on the result page; you also get an email when it finishes ## Plan location limit Each plan includes a number of locations (100 on Starter, 250 on Basic, 500 on Growth, 2,000 on Advanced, unlimited on Premium). If a file would add more new locations than your plan has room for, the upload is stopped with a message that says how many fit. Rows that match an existing location only update it and don't count. Stores that installed before November 9, 2026 have no import limit and import every column. ## Addresses that can't be found When a row has no coordinates, its address is looked up. If the match is weak, or lands in a different country than the row names, the location is still imported but set to **Hidden**, so no wrong pin reaches your store, and the result lists the row. Open the location, check the pin and address, and set **Visibility** to **Visible**. ## The import result The result page shows how many rows were created, updated and not imported. Rows that were not imported are listed under **Rows not imported**, each with the reason. Rows that were imported with something to check (an address saved as Hidden, or columns skipped for your plan) are listed separately under **Notes**. Blank lines in the file are ignored and don't count as rows. ## Updating existing locations - A row with an **ID** (as in an exported file) updates that location - Without an ID, a row with the same **name** and **postal code** as an existing location updates it - Anything else creates a new location --- # Plans & features > Compare Store Locator plans and see which features each one includes Source: https://help.pasilobus.com/store-locator/plans-and-features App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Getting started Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Store Locator comes in five plans so you only pay for what you need — from a free tier for a handful of stores up to unlimited locations. Every plan includes the core locator (interactive map, address & GPS search, and CSV import/export); higher plans add richer location cards, customization, and insights. You can change plans anytime from the app's Settings; billing is handled by Shopify. ## Plans at a glance - **Starter (Free)** - Up to 100 locations. Custom map styling, address & GPS search, and import/export. - **Basic** - Up to 250 locations. Everything in Starter, plus unlimited views & search and Directions & Social Links. - **Growth** - Up to 500 locations. Everything in Basic, plus Business Hours, Custom Fields & Filters, Categories, and Logo Display. - **Advanced** - Up to 2,000 locations. Everything in Growth, plus Location Priority & Ranking and Analytics. - **Premium** - Unlimited locations. Everything in Advanced, plus the Photo Gallery. ## What the paid features do - **Directions & Social Links** (Basic and up) - Show a "Get directions" button on each location and link out to the store's social profiles (Instagram, Facebook, TikTok, and more). - **Business Hours** (Growth and up) - Add weekly opening hours plus special/holiday hours per location, so customers see whether a store is open. - **Custom Fields & Filters** (Growth and up) - Add your own fields to locations (for example "Curbside pickup" or "In-store returns") and let shoppers filter the map by them. - **Categories** (Growth and up) - Group locations into categories that customers can filter by. - **Logo Display** (Growth and up) - Show each location's logo on its map card. - **Location Priority & Ranking** (Advanced and up) - Give locations a priority value to pin featured stores to the top of results, or use it only to break ties between equally close stores. - **Analytics** (Advanced and up) - See how customers use your locator: views, searches, clicks, and engagement over time. **Interactions** counts searches, location and directions clicks, and map moves, so one visit can add several and the line usually sits above Views. **Top Performing Locations** lists clicks per location; clicks on locations you've since deleted count in the totals and are noted under the table. - **Photo Gallery** (Premium) - Add a gallery of images to each location for a richer, more visual store page. ## Changing your plan Upgrade or downgrade anytime from **Settings** in the app. If you move to a lower plan, features above that plan are turned off in the app, on your storefront map and in CSV imports (the storefront updates within a minute of the plan change), but your data (locations, hours, custom fields, and so on) is kept — it becomes available again if you upgrade later. If a plan's location limit is lower than your current number of locations, existing locations stay, but you'll need to be within the limit to add more. Stores that installed Store Locator before November 9, 2026 keep every storefront feature they had (directions, hours, filters, categories, logos and galleries) and unlimited CSV imports, whatever their plan. The admin features above their plan stay locked as before. --- # Map providers > Choose your map provider and set up your API key Source: https://help.pasilobus.com/store-locator/map-settings App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Features Last updated: 2026-02-18 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Choosing a Map Provider Store Locator supports three map providers. Choose the one that works best for your store in **Settings > Map Provider**. ## OpenStreetMap The default option. No API key required and free to use. Works well for most stores. OpenStreetMap is a community-driven project funded by donations. If you find it useful, consider [supporting them](https://supporting.openstreetmap.org). ## Google Maps The most recognized mapping platform. Requires a Google Maps API key. ### How to get your API key 1. Go to the [Google Cloud Console](https://console.cloud.google.com) 2. Create a new project or select an existing one 3. Enable the **Maps JavaScript API** and **Geocoding API** 4. Go to **Credentials** and create an API key 5. Copy the key and paste it in **Settings > API Token** > Restrict your API key to your store's domain for security. In Google Cloud Console, go to **Credentials**, click your key, and add your domain under **Website restrictions**. ## Mapbox Modern maps with smooth animations. Requires a Mapbox access token. ### How to get your access token 1. Create a free account at [mapbox.com](https://www.mapbox.com) 2. Go to your **Account** page 3. Find your **Default public token** 4. Copy the token and paste it in **Settings > API Token** Mapbox includes 50,000 free map loads per month. ## Switching Providers You can switch providers at any time in **Settings > Map Provider**. Your locations and settings are preserved when switching. If you switch to Google Maps or Mapbox, you'll need to enter your API key before the map will display. --- # Languages & translations > Translate the store locator into any language Source: https://help.pasilobus.com/store-locator/widget-customization App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Features Last updated: 2026-02-18 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Managing Languages Store Locator supports multiple languages so your store locator displays in your customers' language. 1. Go to **Settings** and scroll to **Languages & Translations** 2. Click **Manage Languages** 3. Add a new language or edit an existing one ## What Can Be Translated All customer-facing text in the store locator can be customized: - Search box placeholder text - Button labels (e.g. "Search", "Get Directions") - Distance labels and units - Status messages (e.g. "No locations found") - Filter labels ## Adding a New Language 1. Click **Add Language** 2. Select the language from the dropdown 3. Fill in translations for each text field 4. Click **Save** The store locator automatically displays in the customer's browser language if a matching translation exists. Otherwise, it falls back to your default language. --- # Location details > Configure what information displays for each location Source: https://help.pasilobus.com/store-locator/location-details App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Features Last updated: 2026-02-18 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Contact Information Each location can include: - **Phone number** - Displays as a clickable link so customers can tap to call on mobile - **Email address** - Opens the customer's email app - **Website** - Links to a location-specific page, opens in a new tab ## Business Hours Set regular operating hours for each location. Customers will see when the store is open or closed. 1. Open a location and go to the **Business Hours** section 2. Check **Enable business hours** 3. Set opening and closing times for each day of the week 4. Mark days as **Closed** when the location is not open > Business hours are available on Growth plans and above. ## Special Hours Override regular hours for holidays or special events. Special hours take priority over regular business hours on the specified date. 1. Scroll to the **Special Hours** section below Business Hours 2. Click **Add Special Hours** 3. Pick a date, set the hours or mark as closed, and add a label (e.g. "Christmas") ## Social Media Links Add social media profiles for each location. Supported platforms: - Instagram - Facebook - Twitter / X - TikTok - YouTube - LinkedIn Social media links are shown when customers view the location details. > Social media links are available on Basic plans and above. ## Location Logo Upload a logo or photo for each location. The image displays on the location card and helps customers identify the store. > Location logos are available on Growth plans and above. ## Image Gallery Upload up to 10 images per location to give customers a better look at your store. 1. Open a location and scroll to **Image Gallery** 2. Upload images using the file picker 3. To remove an image, check the **Remove** box next to it and save > The image gallery is available on the Premium plan. ## Custom Fields & Filters Add custom information specific to your business, like amenities, services, or any other details. Custom fields can be text, links, or checkboxes that double as filters on the store locator. Manage your custom fields in **Custom Fields** from the navigation menu, then fill in values on each location. > Custom fields are available on Growth plans and above. ## Driving Directions When enabled, each location popup includes a "Get Directions" link that opens in Google Maps or Apple Maps depending on the customer's device. Enable or disable this in **Settings > Search & Display Settings**. > Driving directions are available on Basic plans and above. --- # Search & display settings > Configure search behavior, map display, and geolocation Source: https://help.pasilobus.com/store-locator/search-and-filters App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Features Last updated: 2026-02-18 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Distance Units Choose between **Miles** and **Kilometers** for displaying distances in search results. This applies to both the distance shown next to each location and the search radius dropdown. ## Default Map View Configure what customers see when they first load the store locator: - **Empty map** - Customers must search to see locations - **Geolocate nearby stores** - Automatically detect the customer's location and show nearby stores - **Display all stores** - Show every location on the map > When set to **Geolocate**, the browser will ask the customer for permission to access their location. This is a standard browser prompt — the store locator does not control its appearance or wording. > > If the customer **allows** location access, the map centers on their position and shows nearby stores. If the customer **denies** permission or their browser does not support geolocation, the map falls back to showing all locations. ## Geolocation Display Mode When using the **Geolocate** option, you can choose how many stores to show: - **Automatic** - Adjusts based on store density in the customer's area - **5, 10, 20, or 50 closest stores** - Shows a fixed number of nearest locations ## Default Search Radius Set the starting search radius when customers search for locations. Options range from 5 to 1000, or **Unlimited** to show all locations regardless of distance. A larger radius works better if your locations are spread far apart. A smaller radius is better for dense coverage areas. When a search finds a place but no store is within the radius, shoppers see "Sorry, we didn't find any stores nearby." with the nearest store underneath, labelled **Nearest store** and its distance. When the search text isn't a place at all, they see "We couldn't find that place. Check the spelling, or try a city or postal code." You can change both messages, and the **Nearest store** label, in your translations. ## Map Marker Clustering When customers zoom out on the map, nearby markers can be grouped into clusters to keep the view clean: - **Cluster nearby markers** (recommended) - Groups overlapping markers with a count badge - **Always show individual markers** - Every location pin is always visible ## Location Priority Give locations a priority value (set per location, or in bulk via CSV import) to control their order in search results: - **By distance** - Priority only breaks ties between locations that are equally close (the default) - **Featured first** - Higher-priority locations are pinned to the top of results, ahead of closer ones > Location priority is available on Advanced plans and above. ## Driving Directions When enabled, each location popup includes a "Get Directions" link. Customers are taken to Google Maps or Apple Maps depending on their device. > Driving directions are available on Basic plans and above. --- # Theme integration > Add Store Locator to your theme using the app block Source: https://help.pasilobus.com/store-locator/theme-integration App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Features Last updated: 2026-02-20 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) Store Locator uses a **theme app block** to display on your storefront. You can add it to a dedicated page or embed it alongside other content on any page. ## Creating a Dedicated Store Locator Page This is the most common setup — a full page dedicated to your store locator. ## Step 1: Create a Page Template Your standard pages (About, Contact and so on) share the Default page template, so a block added there shows on all of them. Give the locator its own template: 1. Go to **Online Store > Themes** and click **Customize** on your theme 2. In the template menu at the top of the editor, open **Pages** and click **Create template** 3. Name it `store-locator`, base it on **Default page**, and click **Create template** ## Step 2: Create the Page 1. In your Shopify admin, go to **Online Store > Pages** 2. Click **Add page** 3. Enter a title like "Store Locator", "Find a Store", or "Our Locations" 4. You can leave the page body empty — the app block will provide all the content 5. Set **Theme template** to `store-locator` 6. Click **Save** ## Step 3: Add the App Block The app's setup guide does this for you: **Add block in theme editor** opens the `store-locator` template with the block added. To do it by hand: 1. In the theme editor, open the `store-locator` page template from the template menu 2. Click **Add section** 3. Under **Apps**, select **Store Locator** 4. Click **Save** Your store locator page is now live. Visit the page URL to see it in action. ## Adding to an Existing Page You can embed the store locator on any page that supports sections, such as your Contact page or homepage. ## On a Page Template 1. Go to **Online Store > Themes** and click **Customize** 2. Navigate to the page where you want the store locator 3. Click **Add section** 4. Under **Apps**, select **Store Locator** 5. Drag the section to position it where you want 6. Click **Save** > The app block works on any page template that supports sections. This includes the default page template, custom templates, and the homepage. ## App Block Settings After adding the Store Locator block, you can configure it directly in the theme editor: - **Search bar** - Show or hide the search input - **List position** - Place the location list on the left or right side of the map - **Map height** - Adjust the height of the map display These settings are per-block, so you can have different configurations on different pages. ## Adding a Navigation Link Make your store locator easy to find by adding it to your navigation menu: 1. Go to **Online Store > Navigation** 2. Select the menu to edit (e.g., **Main menu** or **Footer menu**) 3. Click **Add menu item** 4. Enter a name like "Locations" or "Find a Store" 5. In the link field, search for and select the store locator page 6. Click **Save menu** ## Mobile Responsiveness The store locator automatically adjusts for mobile devices: - Map and location list stack vertically on small screens - Touch-friendly controls and gestures - Optimized for mobile performance - "Get Directions" links open native map apps on mobile Test the store locator on various devices to ensure a good experience for all customers. --- # Map not showing > Fix issues with the map not displaying Source: https://help.pasilobus.com/store-locator/map-not-showing App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Troubleshooting Last updated: 2026-02-20 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Check the App Block is Added The most common cause is the Store Locator app block not being added to your page: 1. Go to **Online Store > Themes** in Shopify admin 2. Click **Customize** on your active theme 3. Navigate to the page where you expect the store locator 4. Check that a **Store Locator** section exists under **Apps** 5. If not, click **Add section** and select **Store Locator** from the Apps list 6. Click **Save** After adding the block, refresh your store locator page. ## Verify API Key Configuration If you're using Google Maps or Mapbox, a valid API key is required. OpenStreetMap works without a key. ### For Mapbox 1. Go to **Settings > Map Provider** in Store Locator 2. Check that a Mapbox Access Token is entered 3. Verify the token at [mapbox.com/account](https://account.mapbox.com) 4. Ensure the token hasn't expired or been revoked ### For Google Maps 1. Go to **Settings > Map Provider** in Store Locator 2. Check that a Google Maps API Key is entered 3. In Google Cloud Console, verify: - Maps JavaScript API is enabled - Geocoding API is enabled - API key restrictions allow your domain ### For OpenStreetMap No API key is needed. If the map still doesn't show, the issue is likely theme-related. ## Check Theme Compatibility Some themes may conflict with the store locator: 1. Try the store locator on a default Shopify theme (Dawn) 2. If it works on Dawn, the issue is theme-specific 3. Check for JavaScript errors in browser console (F12 > Console) 4. Look for CSS conflicts that may be hiding the map container ## Browser Console Errors Check the browser console for specific error messages: 1. Open your store locator page 2. Press F12 to open Developer Tools 3. Click the Console tab 4. Look for red error messages Common errors: - "API key invalid" - Check your API key in Settings - "Refused to load script" - Content Security Policy issue with your theme - "mapboxgl is not defined" - Mapbox script failed to load ## Geolocation Not Working If the map is set to **Geolocate nearby stores** but isn't detecting your customer's location: 1. **Browser permission** — The customer must allow the location permission prompt. If they previously denied it, they need to reset the permission in their browser's site settings (click the lock icon in the address bar). 2. **HTTPS required** — Geolocation only works on secure (HTTPS) connections. Shopify stores always use HTTPS, but if you're testing on a custom domain, make sure SSL is active. 3. **Incognito/private mode** — Some browsers block geolocation by default in private browsing. Test in a regular browser window. 4. **VPN or network restrictions** — Corporate networks and VPNs can block or interfere with browser geolocation. If geolocation fails, the store locator automatically falls back to showing all locations on the map. ## Clear Cache Sometimes cached data causes display issues: 1. Clear your browser cache and cookies 2. Try viewing in an incognito/private window 3. If using a CDN or caching app, purge the cache --- # Locations not appearing > Fix invisible store locations Source: https://help.pasilobus.com/store-locator/locations-not-appearing App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Troubleshooting Last updated: 2026-01-21 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## Storefront Out of Date Every change you save is sent to your storefront within a few seconds. If Shopify refuses an update, your store locator keeps showing the locations and settings from the last update that went through, and your dashboard shows a **Your storefront is out of date** banner with the reason Shopify gave. 1. Open the Store Locator dashboard 2. Click **Resync storefront** in the banner 3. The banner goes away once Shopify accepts the update If the banner comes back after a resync, contact us with the message it shows. ## Check Location Visibility Locations can be hidden from customers: 1. Go to **Locations** in Store Locator 2. Find the location that's not appearing 3. Check if it shows a "Hidden" badge 4. Edit the location and set **Visibility** to **Visible** 5. Save the changes Hidden locations are saved but don't appear in the store locator. ## Verify Coordinates Exist Locations need latitude and longitude to appear on the map: 1. Edit the location in Store Locator 2. Scroll to the coordinates section 3. Check that latitude and longitude have values If coordinates are missing: - Re-enter the address and save to trigger geocoding - Or enter coordinates manually if you have them When pins are missing, impossible or outside the country in their address, the **Locations** page shows a banner with a **Fix coordinates** button. It looks those addresses up again; any match the map service isn't sure of is left for you to fix in the location. ## Search Radius Too Small Customers might be searching with too small a radius: 1. Check your default search radius in **Settings** 2. If locations are spread out, increase the default radius 3. Add larger radius options to the dropdown Customers can only find locations within their selected search radius. ## Geocoding Failures Some addresses fail to geocode (convert to coordinates): Reasons addresses might fail: - New addresses not yet in mapping databases - PO Box addresses (not physical locations) - Incomplete or misspelled addresses - Rural addresses with limited mapping data Solutions: - Enter the full, complete street address - Add city, state, and postal code - Manually enter coordinates from Google Maps ## Check for Duplicate Locations Duplicate entries might cause confusion: 1. Go to **Locations** and look for similar entries 2. Remove any duplicates 3. Keep the location with complete information ## No Locations in Region If searching returns no results: - Verify you have locations in that geographic area - Check the search radius covers the distance to nearest location - When nothing is within the radius, the locator shows the nearest store with its distance under the "no stores nearby" message --- # Import errors > Fix CSV import problems Source: https://help.pasilobus.com/store-locator/import-errors App: Store Locator (on the Shopify App Store as "Pasilobus Store Locator") Shopify App Store: https://apps.shopify.com/pasilobus-store-locator App help: https://help.pasilobus.com/store-locator Section: Troubleshooting Last updated: 2026-01-21 Support: email support@pasilobus.com or send a request from https://cloud.pasilobus.com/support (no chat) ## CSV Format Issues The CSV must be properly formatted: ### Correct Format - First row must be column headers - One location per row - Comma-separated values - Text with commas should be quoted ### Example of Correct Format ``` name,address_line1,city,state "Joe's Coffee, Inc.",123 Main St,New York,NY Downtown Store,456 Oak Ave,Chicago,IL ``` ### Common Mistakes - Missing header row - Rows that are only commas or spaces are skipped automatically, so they don't cause errors - Inconsistent quoting ## Missing Required Fields Every location needs at minimum: - **name** - A name for the location - **address_line1** - The street address - **city** - The city - **country** - The country name or code Check your CSV has these columns and every row has values. ## Invalid Data Formats Ensure data is in the correct format: ### Coordinates - Latitude: decimal number between -90 and 90 (e.g., 40.7128) - Longitude: decimal number between -180 and 180 (e.g., -74.0060) - Don't include degree symbols or N/S/E/W ### Visibility - Use: yes, no, true, false, 1, 0, Visible or Hidden ### Phone Numbers - Any format is accepted - Include country code if international ## Encoding Problems CSV files must use UTF-8 encoding for special characters: ### Symptoms - Accented characters appear garbled (é becomes é) - Import fails with encoding errors - Some rows import incorrectly ### Solutions 1. Open the CSV in a text editor (not Excel) 2. Save As with UTF-8 encoding 3. Or in Excel: Save As > CSV UTF-8 (Comma delimited) ## Rows Not Imported Because of the Plan Limit If the file would add more new locations than your plan has room for, the upload is stopped and the message says how many fit. Upgrade your plan, remove locations you no longer need, or import fewer rows. Rows that update an existing location don't count. ## Columns Skipped for Your Plan Hours, categories and custom fields (Growth and above), social links (Basic and above) and priority (Advanced and above) are only imported on plans that include them. The import result names each skipped column. ## Locations Imported as Hidden A row whose address can't be found reliably, or is found in a different country than the row names, is imported as **Hidden** so no wrong pin appears on your store. Open the location, check the address and the pin, then set **Visibility** to **Visible**. ## Large File Issues Very large files might timeout: - Split into smaller files (500-1000 locations each) - Import in batches - Ensure stable internet connection during import ## Re-importing Updated Data To update existing locations: - Use the same location name to match existing entries - Changed data will overwrite the existing location - New names create new locations If you're seeing duplicates, check that names match exactly (including spacing and capitalization).