Skip to main content

Custom Map Markers: Upload, Sizing, and Assignment

Upload a custom map marker, control its displayed size, and choose which locations use it.

Use this guide to replace the standard map pin, make your custom marker larger or smaller, and control which locations use it.

Upload a custom marker

  1. Go to the Markers page

  2. Click New Marker

  3. Upload a PNG, JPG, or SVG file under 1MB

  4. Save the marker

A transparent PNG or SVG works best. Use a square canvas and make the artwork fill most of it. Large transparent margins make the visible marker look smaller.

Change the displayed marker size

The dimensions of the uploaded file don't control how large the marker appears on the map. StoreRocket scales custom markers to the size selected for the project.

  1. Find Marker Size

  2. Choose Extra Small, Small, Medium, Large, or Extra Large

  3. Save and check the live store locator

The selected size applies to every custom marker in the project. It doesn't change the standard Google Maps or Mapbox pin.

Assign a marker to specific locations

  1. Go to the Locations page

  2. Open a location

  3. Choose the marker in the Marker field

  4. Save the location

Uploading a marker doesn't assign it automatically. A location keeps the standard map pin until a custom marker is selected.

Assign a marker to every existing location

On the Markers page, click Assign to all beside the marker.

This replaces the marker assignment on every existing location. Use it only when the same marker should appear everywhere.

Use a marker for new locations

Click Set as default beside the marker to use it for new locations created in the dashboard, through imports, or through the API.

Setting a default doesn't update existing locations, so use Assign to all when those should change too.

For CSV and Google Sheets imports, use the marker's numeric ID in the Marker ID column. You can find the ID on the Markers page.

Troubleshooting

A larger uploaded image still looks the same size. Change Marker Size in Widget Settings. Increasing the source image dimensions only changes its resolution.

The artwork still looks small. Reduce the empty transparent space around the artwork while keeping the canvas square, or choose a larger Marker Size.

The marker isn't showing. Check that it is assigned to the location. Uploading the file alone doesn't apply it.

The marker is too large. Choose a smaller Marker Size. You don't need to upload a smaller file.

The old marker still appears. Save the change, then refresh the live store locator. If needed, do a hard refresh with Ctrl+Shift+R on Windows or Cmd+Shift+R on Mac.

Did this answer your question?