StoreSpot / Help & information

Documentation

Set up your locator, organize your network and keep the information useful for shoppers.

1. Install and add the app block

1. Install StoreSpot in a Shopify store with the Online Store sales channel. Open StoreSpot in Shopify admin. No separate StoreSpot account is required.
2. Use the setup guide on Home. Create a group in Locations, then add at least one location with the information you want to publish.
3. Open Appearance and preview the locator. Save your changes.
4. Open Shopify’s theme editor from the app’s setup link. Select or create the page template intended for your locator.
5. Add the Store Locator app block in a section that supports app blocks. Choose the host section’s width settings in your theme.
6. Save the theme, create/select the corresponding Shopify page and assign the intended template. Open the actual storefront page to test it.

StoreSpot uses the theme’s native section width. It does not automatically turn every theme section into a full-width page. An app block in an unassigned template will not appear on the page you are viewing.

2. Organize groups and locations

Use groups for meaningful parts of your network: for example Stores, Stockists and Showrooms. The app supports one locator and up to three saved groups. Choose shared or grouped presentation in Appearance according to how you want shoppers to browse.

In Locations, add/edit a location, set its group and active state, and order the list. List changes are drafts until saved. Use the Save Bar to save or discard together. If the app reports an interrupted save, follow the recovery instructions before making further edits; do not repeatedly resubmit a conflicting change.

The saved-record ceiling is 2,000 active and inactive locations combined. A plan may publish fewer. Before deleting a group containing locations, review the affected data and export a copy if needed.

Location details

Enter the store/business name, address, public contacts, website/social links and description you want shoppers to see. Keep published information accurate and use contact details you are authorized to disclose.

Map position: select the country and enter the address. The editor can look up a position, subject to lookup availability and usage limits. A confident result can place a new location automatically; select from the candidates when the result is ambiguous. You can also click or drag on the editor map, or enter latitude/longitude. Confirm the marker before saving. Without valid coordinates, a location can be listed without a marker.

Hours: enter the weekly schedule and check the timezone associated with the coordinates. Open-now and day/time filtering depend on these values. On every plan, use Special hours for closures or different hours on specific dates; these override the weekly schedule. Consecutive dates with identical hours can appear as one range. Pro and Max add bulk editing and special-hours spreadsheet import/export. The weekly schedule uses one opening period per day.

Special hours can be scheduled 1 calendar month ahead on Free, 3 calendar months on Basic, 1 calendar year on Plus and 2 calendar years on Pro or Max. Free allows 2 upcoming entries per location; each entry is one date with one opening period or a closure, and a date range counts once per date. A past entry frees its place automatically. Paid plans allow every date within their scheduling window. Free keeps no past-date history; paid plans keep 2 calendar months. Upcoming changes can be shown up to 30 days ahead on Free or Basic and 90 days on Plus, Pro or Max. Previously saved future exceptions remain available after a downgrade; new entries follow the current plan.

Images: choose authorized assets through Shopify Files. Gallery limits are one image on Free, three on Basic, five on Plus and six on Pro or Max. Location logos are available from Basic. Removing a reference does not delete the source file from Shopify Files.

3. Services, search and nearby results

In Services, maintain a concise catalogue of up to twelve services. Choose names/icons and their order, then assign the appropriate services in each location’s editor. A service should represent an actual capability, not simply repeat the group name. Built-in automatic filters use these assignments.

Storefront text search matches saved names, businesses, addresses and group text. It is not a product search or global place-autocomplete service. A city or postcode must be present in the saved information to match as text.

The Use my location control is optional for the shopper. After browser permission, straight-line distances are calculated locally, displayed in the configured units and used for ordering within each group. Clear the position to restore the previous order. If permission is denied, use ordinary search or change browser permissions. Directions opens an external Google Maps destination link.

4. Appearance and languages

Choose Store showcase or Compact list, then adjust layout order, map style, colors, fonts and dimensions. Desktop and mobile previews help you inspect the same locator renderer used on the storefront. Save or discard the changes deliberately.

Group-image markers on Plus and above apply at group level. They are not per-location icon overrides. Check that an image marker remains recognizable at map size and does not hide required map attribution.

Choose the admin language in Settings → General, or with the language picker on Home. This changes the app language for that browser, independently of the storefront. Built-in labels support 26 languages. Storefront labels follow the store’s active locale; your own location descriptions do not automatically translate. Every plan can customize storefront labels/translations in Settings.

After theme changes, check the published storefront on desktop and a phone. The theme’s container width, page template and surrounding sections still influence the layout.

5. Import and export

1. Export the existing location data before a substantial update.
2. Create the destination groups first. Download the current template from Import / Export.
3. Prepare an XLSX or UTF-8 CSV file within the 5 MB and 2,000-row limits. CSV exports are available with comma or semicolon separators.
4. For existing locations, preserve their exported identifiers/handles when making updates. For new locations, follow the template’s rules. Do not invent IDs.
5. Upload, map the columns and inspect the preview. Resolve group mismatches, malformed numbers and reported validation errors.
6. Confirm the import, review its result and export again to verify the saved records.

Location imports require Plus or above; location-data exports are available on every plan. The app processes batches of 25 rows. Successfully saved earlier batches remain saved if a later batch fails. Correct the affected rows and follow the result details; do not assume the whole operation rolled back.

Some supported fields allow the explicit [CLEAR] token to remove a value. Use the current template/validation rules to determine where it is allowed; do not apply it indiscriminately. A blank cell is not a universal command to delete an existing field. There is no live Google Sheets sync. Spreadsheet import does not automatically geocode addresses; supply valid coordinates or set positions in the location editor.

6. Understand activity

Measure shows activity for the selected period and metric. Basic adds line charts and custom date ranges. Plus adds bar charts, contact metrics, live counts and period comparisons. Pro and Max add location breakdowns and report exports. The Excel summary includes four trend charts and a phone, email and website breakdown. When comparison data falls outside the retained range, the app marks it unavailable rather than treating it as zero.

Consent must allow analytics through Shopify’s Customer Privacy API; unavailable/denied consent produces no events. Theme editor and app preview activity is excluded. Reports cover current/previous calendar-year daily totals; hourly detail is short-lived. See the Privacy Policy for reporting windows and the daily cleanup process.

7. Plans and billing

Free supports 1 location and 1 active group; Basic supports 3 locations and 1 active group. Plus supports 50 locations, Pro 500 and Max 2,000, with up to 3 active groups. Basic adds service/hour filters and trend charts. Plus adds location import, compact cards, grouped presentation, text search, clustering, group image markers and comparisons. Pro and Max add location analytics, report export and bulk special-hours tools. Custom storefront labels and location-data export are available on every plan. Photo and service limits vary by plan.

Choose a plan through the app and approve it in Shopify. Check the displayed price, trial eligibility and billing terms before accepting. Downgrading keeps saved records but restricts publication. After changing a plan, return to the app and verify the current plan and visible locations. Development access may differ from a real paid subscription.

8. Troubleshooting

The locator is missing

Check the published theme, assigned page template, app block placement, active group/location and plan publication limit. An editor preview alone does not prove the live page is configured.

The map is visible but a marker is missing

Check latitude/longitude and active/plan state. Address text alone is not enough for a marker.

The map background fails but locations remain

Check network access to map assets and retry. Report the storefront URL, browser and time of the problem; do not delete your locations to fix a map-hosting issue.

A location does not match a search

Check the saved name/address/group text and active service/hour filters. Clear the shopper position if nearby ordering is confusing. Search is not an external geocoder.

Open-now results look wrong

Review the weekly hours, special-hours overrides, location coordinates/timezone and the test time. A closure or special schedule for that date takes precedence over weekly hours.

Import fails

Review the reported row, file format/size, group mapping and remaining saved-location capacity. Earlier successful batches may already be saved.

Analytics looks empty

Test on the actual storefront after permitted consent, not in a preview. Select the correct period and metric. Report errors separately from zero counts.

A save needs recovery

Use the app’s recovery path and keep other edits on hold until it completes. Include the visible error in a support request; do not send credentials.

9. Uninstall and data deletion

1. Export the data you want to retain and review existing Shopify charges.
2. Uninstall StoreSpot through Shopify’s app management.
3. Shopify’s validated notifications trigger cleanup of the app’s shop-scoped session, recovery and analytics data. Backups and logs have separate retention. See the Privacy Policy for retention and recovery details.
4. Review your Shopify Files separately: the app does not delete underlying image files on uninstall.
5. For privacy requests, use the contact listed on the Privacy page, identifying the relevant shop and your authority to act.

Uninstalling removes the app-owned catalog. Do not rely on reinstalling as a backup/restore method. Shopify-owned resource lifecycles and app-database cleanup are different. For help, see Support.