Managing StoresUpdated 2026-08-25

Change a store marker or directions link

What this article helps you do

Replace the default map marker and directions link for specified stores. Use the two custom fields when the defaults are not correct.

Before you start

  • You have stores in Mapstore.
  • You have a public URL for your custom marker image.
  • For custom directions, you have a full directions URL. For example, use a Google Maps, Apple Maps, or Waze link.

Step-by-step instructions

1. Set a custom directions URL

  1. Go to Stores.
  2. Open a store or create a store.
  3. Find the Custom directions URL (or Directions URL) field.
  4. Enter the full URL that opens when a shopper clicks “Get directions” for this store.
  5. Use one of these URL formats:
    • Google Maps: https://www.google.com/maps/dir/?api=1&destination=...
    • Apple Maps: https://maps.apple.com/?daddr=...
    • Waze: https://waze.com/ul?ll=...
  6. To use the default directions behavior, leave the field blank.
  7. Save the store.

2. Set a custom marker image

  1. In the same store form, find the Custom marker image field.
  2. Paste a public HTTP or HTTPS image URL.
  3. To select a Shopify file, click Upload image.
  4. Click Choose or upload from Shopify Files and select the image.
  5. The recommended image size is 30 by 30 pixels.
  6. To use the default Mapstore marker, leave the field blank.
  7. Save the store.

3. Use in CSV or Google Sheets

If you import from CSV or Google Sheets:

  • Custom directions URL: use column customDirectionsUrl
  • Custom marker image: use column customMarkerImage

Example CSV row:

name,address,customDirectionsUrl,customMarkerImage
Store A,123 Main St,https://maps.google.com/...,https://cdn.example.com/marker-a.png

How to verify it worked

  1. Open the store on the storefront map.
  2. If you added a custom marker image, make sure that you can see the image.
  3. Click “Get directions” for the store.
  4. Make sure that the custom directions URL opens.
  5. Check a store without custom values.
  6. Make sure that it uses the default marker and directions.

Troubleshooting

Issue Fix
Custom marker is not on the map Make sure that the image URL is public and returns an image. Open the URL in a browser.
Directions link uses default URL Check that Custom directions URL is saved and contains a correct URL.
Image is stretched or has incorrect size Use a square image that is approximately 30 by 30 pixels.
CSV column not applied Use exact column names customDirectionsUrl and customMarkerImage.