Skip to main content

How to Edit Map Markers/Icons

This guide explains how to edit map markers/icons in the new UI, including color, shape, image, size, labels, clustering, and field-driven marker variations. It also covers two ways to access marker settings: from the Map Editor and from the Collections.

Written by Lucia Diaz

Key Steps

1. Open the map you want to edit 0:10

generated-image-at-00:00:10
  • Go to Assets > Maps.

  • Select the specific map you want to update.

  • This opens the Map Editor, where marker settings can be changed.

2. Open the marker settings in Map Style 0:19

generated-image-at-00:00:19

  • In the Map Editor, click Markers under Map Style.

  • Use this area to edit the default marker style for points on the map.

  • This is the best place to update markers that should look the same across all listings or locations.

3. Edit the default marker appearance 0:39

generated-image-at-00:00:39

  • Change the marker color if needed.

  • Choose a shape such as:

    • Circle

    • Square

    • Star

    • Diamond

    • Hexagon

  • Search for an icon if you want a specific symbol.

  • Upload your own image or paste an image URL to use as the marker.

4. Set markers to vary by field value 1:15

generated-image-at-00:01:15
  • In Map Style, select Driven by Field.

  • Choose the field that should control the marker icon.

  • Each place will display a different icon based on its field value.

  • Records without a value will use the default marker style (blue circle).

5. Assign icons to categories or field values 1:42

generated-image-at-00:01:42
  • Select the relevant field, such as category.

  • Review the icons assigned to each value in that field.

  • Example values may include:

    • Restaurants

    • Cafes

    • Breweries

    • Museums

    • Attractions

    • Parks

  • Confirm each category has the correct icon style.

6. Edit a specific category marker 2:05

generated-image-at-00:02:05
  • Click the category or value you want to change, such as restaurants.

  • A panel will appear on the right side.

  • Click Edit Marker.

  • Update the marker by changing:

    • Color

    • Shape

    • Icon search result

    • Uploaded image

  • When finished, click Close Marker and continue editing other values as needed.

7. Save and verify marker changes 2:44

generated-image-at-00:02:44
  • Marker updates are saved automatically.

  • Exit the editor and verify the map visually.

  • Confirm the updated markers appear correctly, such as restaurants showing as a red star.

8. Adjust marker size 2:56

generated-image-at-00:02:56
  • In the Markers section, locate the Size Editor.

  • Use the size control to increase or decrease marker size.

  • Choose a size that is readable without overcrowding the map.

9. Add numbers or labels to markers 3:17

generated-image-at-00:03:17
  • Select a field to label each pin.

  • Use a field with a number type if you want numbered markers.

  • Example: a custom field like Point Number can display numbers on top of each icon.

  • Verify the labels appear correctly for all numbered locations.

10. Review clustering and location field settings 3:57

generated-image-at-00:03:57
  • Adjust clustering if you want nearby markers grouped together.

  • Review the field used for marker location.

  • By default, pins may use the address field.

  • If needed, switch to another available field.

  • If a place has no address and should not appear, configure the map accordingly.

11. Edit markers from the Collection fields 4:17

generated-image-at-00:04:17
  • Return to the dashboard/home page.

  • Click Collections.

  • Open the collection connected to the map you want to edit.

  • Click Fields to view the fields tied to the map filters.

12. Update a marker from a collection field value 4:52

generated-image-at-00:04:52
  • Open the relevant field, such as category.

  • Click the specific value you want to edit, such as restaurants.

  • Select Edit Marker.

  • Search for a new icon or upload your own image.

  • Click Close Marker when finished.

  • Changes save automatically, so no manual save is required.

Cautionary Notes

  • Marker changes are saved automatically, so avoid refreshing or navigating away before confirming the update.

  • If a field value has no assigned marker, it may fall back to the default blue circle.

  • When using Driven by Field, make sure the selected field contains consistent values; inconsistent data can cause unexpected icons.

  • If you upload custom images, ensure the image is clear and appropriately sized for map display.

  • If you change the location field, verify that all records still display in the correct place on the map.

Tips for Efficiency

  • Decide first whether you need one universal marker style or field-driven marker variations before editing.

  • Use the collection field editor when you want to update many map markers tied to the same field values.

  • Keep a consistent icon style across similar categories to make the map easier to read.

  • Test one category first, then apply the same approach to the remaining values.

  • Use marker labels sparingly so the map stays readable, especially when many points are displayed.

Link to Loom

Did this answer your question?