Getting Started — SyncaMap Support
SyncaMap

Getting Started

SyncaMap is a Shopify store locator that can build itself from your order data. This guide is the recommended path from a fresh install to a live storefront map. Work through the steps in order — each one builds on the last.

The fastest way to a great locator is to set up how products should display before you turn on automatic syncing, so every location is created correctly from the start. The order below reflects that.

1. Install the app

Install SyncaMap from the Shopify App Store. After installing, open it from your Shopify admin under Apps → SyncaMap.

On first load, SyncaMap creates your store record and starts you on the Free plan. You can upgrade any time from the Plans page.

The app menu has these sections:

  • Dashboard — usage stats, location count, and recent activity.
  • Locations — view, add, edit, import, and export your locations.
  • Notifications — alerts about synced locations, sync errors, and plan limits.
  • Sync — configure sync rules, product rules, and customer confirmation.
  • Map Settings — marker themes, map appearance, display options, and embed instructions.
  • Analytics — storefront usage insights (Growth and Wholesale Pro plans).
  • Plans — view tiers and change your subscription.

You do not need your own Mapbox account or API key. SyncaMap handles all mapping and geocoding for you within your plan's monthly map-load limit.

2. Get to know location management

Everything in SyncaMap revolves around locations — the stores and stockists shown on your map. There are three ways to get them in:

  • Manual entry — add one location at a time. Good for getting started and for one-offs.
  • CSV import — bulk-load an existing list (Starter and above).
  • Auto-sync — create locations automatically from your wholesale orders. This is SyncaMap's whole point.

Add one location manually now to see how it works: Locations → Add location, enter a name, pick an address from the autocomplete suggestions, set visibility to Visible, and Save. It's geocoded and appears on your map.

But adding locations by hand doesn't scale. With auto-sync, every qualifying wholesale order becomes a map pin automatically — the address, the products carried, and the last order date are all pulled straight from the order. Your locator stays current with zero manual data entry. Setting that up is the heart of the next three steps.

One thing to understand before you turn sync on: when a location is created from an order, SyncaMap records the products on that order and resolves them into the names and links shown to shoppers at that moment, using your product rules. That's why we configure product rules first.

→ Full details: Managing Locations

3. Configure Sync → Product Rules

Raw order products are rarely what you want shoppers to see — they may be wholesale variants, internal SKUs, or SEO-heavy titles. Product rules map a raw product to a clean display name and link (for example, point a wholesale SKU at its retail product page, or hide fees and samples).

Set these up before your sync rules. Because locations store their display products at the moment they're synced, getting product rules in place first means every auto-synced location is born showing the right thing — no clean-up pass needed later.

You build product rules by searching your Shopify product catalog directly, so you can define them before any location exists.

→ Full details: Product Rules

4. Configure Sync → Sync Rules

Sync rules are the engine: each rule describes which orders should become locations (for example, Customer tag is wholesale). When a matching order comes in, SyncaMap extracts its shipping address and products, geocodes it, and creates a location — applying your product rules along the way.

Product rules are a dependency of this step. Locations save their display products when they're synced, so set up Product Rules first. If you add product rules afterward, use Re-resolve all to refresh existing locations.

You can also backfill historic orders (Starter and above) to populate the map from past sales.

→ Full details: Sync Rules

5. Configure Sync → Customer Confirmation

For wholesale relationships, you can let each customer review and confirm their own listing before it goes public — they can correct their details and choose which products appear. It's a per-sync-rule setting.

→ Full details: Customer Confirmation

6. Map Settings

With locations flowing in, make the map look like your brand. Under Map Settings you can choose a map style, design marker pins (color, custom SVG, cluster color), enable clustering, and control what storefront visitors see (search box, location list, products, product grouping).

→ Full details: Map Settings

7. Add the map to your storefront

The map is added to your theme as a theme block — no code required:

  1. In Shopify admin, go to Online Store → Themes.
  2. Click Customize on your active theme.
  3. Navigate to the page where you want the locator (for example, a "Where to Buy" page).
  4. Click Add section (or Add block), open the Apps tab, and select Store Locator.
  5. Adjust the Map Height setting if needed.
  6. Save, then Preview to see the map with your locations.

You can find these same steps any time under Map Settings → Embed Instructions.

8. Everything else

You're live. From here:

  • Billing & Plans — unlock CSV import, more sync rule types, larger limits, analytics, and branding.
  • Analytics — see how customers use your locator (Growth and Wholesale Pro).
  • Notifications — keep an eye on synced locations, sync errors, and plan-limit warnings.
  • Troubleshooting & FAQ — answers to common questions.

Need more help? Email support@syncamap.com.