Skip to main content

Changing Your Map's Pin Icons, Shapes, Size, and Clustering

This SOP explains how to customize map pins/markers in Proxi so map points display correctly and consistently. It covers marker style, field-driven categories, marker size, and clustering options.

Written by Melinda Haughey

This article is about the Proxi admin app at app.proxi.co.

Pins are the first thing anyone notices on your map. You can give every place the same pin, or let each category carry its own icon — and you can make them all bigger or smaller in a couple of seconds. It all lives in one place.

Link to video

Open Marker Settings in Your Map Editor

  • Open your map from the Maps page

  • Click on the Markers section in the settings rail on the left. The preview on the right is your real live map, so every change shows up instantly, and everything saves as you go.

  • Review the available display options before making changes.

  • Start with Marker Style, which controls how map points appear on the map.

One Pin Style for the Whole Map

  • Expand Marker style and pick All the same. You'll get one pin design that every place uses. Three ways to set it:

    • Color + shape — pick a color, then a shape: Circle, Square, Star, Diamond, or Hexagon. Simple and always crisp.

    • Icon search — search a big icon library for something that fits, like a coffee cup or a music note.

    • Custom image — upload your own artwork.

A Different Pin for Each Category

This is what most maps want: produce stands in green, food trucks in orange, restrooms with their own icon.

  • Expand Marker style and pick Driven by a field.

  • Under Field, choose the field that should decide the icons — usually Category, but any dropdown or multi-select field works.

  • Each place now gets the icon attached to its value for that field. A place with no value falls back to whatever you set under All the same.

Below the field picker you'll see a card headed Options on "Category" listing every option with its current pin. Click any one to open it.

Restyle a Category on Just This Map

Here's the part that trips people up, so it's worth being clear about.

  • Your categories and their icons belong to the collection, and a collection can feed several maps. Change an icon there and it changes on all of them. That's usually what you want — but not always. Maybe your summer market map wants brighter pins than the year-round directory that uses the same vendor list.

  • So the options list inside Marker style changes that map only. As the panel says: These changes apply to this map only. The shared option defaults stay as they are everywhere else.

  • Click a category in the Options on "Category" list to expand it.

  • Set a new Color + shape, Icon search, or Custom image.

  • Adjust Size to make just that category's pins bigger or smaller than the rest.

  • Each row tells you which is which: a category you've restyled here reads Custom for this map, and one still following the shared icon reads Default. To put a category back the way it was everywhere else, open it and reset it.

Want the change to apply everywhere instead?

  • Click Edit shared option defaults at the bottom of the list — that opens the fields editor, where the icon belongs to the collection and every map using it will pick up the change. See Setting Up Categories, Fields, and Labels

  • Open each marker option and select Edit marker.

    • For each category option, choose one of the following:

      • A color and shape

      • A built-in icon

      • A custom image

    • Repeat this for every category that needs a unique marker style.

Make All Your Pins Bigger or Smaller

  • In the Markers section, expand Size.

  • Drag the slider. The pixel size shows next to the heading as you drag, and the preview resizes with it.

  • The range runs from 16 to 64 pixels. Somewhere in the middle suits most maps — go bigger for a printed handout or a map with only a handful of stops, smaller when you have hundreds of pins and want the streets to stay readable underneath.

Making One Category Stand Out

The per-category size slider is the easiest way to draw the eye somewhere. Sponsors, main-stage venues, or the information booth can sit a few sizes larger than everything else so they read first, without changing a single icon.

Adjust the Clustering and Spread out Stacked Pins

  • Adjust clustering based on how close points appear on the map.

  • When a map gets crowded, nearby places group into a single cluster pin with the number of points in the middle.

  • Click on Markers and click on Clustering to expand the section

    • Choose between Off, light, balanced, or tight clustering depending on how much grouping you want.

    • If multiple pins share the same location, enable the option to spread out stacked pins.

    • Use spreading for common overlap scenarios such as multiple locations at the same address.

Want to show numbers on markers? see the Showing Numbers on Your Map's Markers document

Cautionary Notes

  • Your filter buttons follow your pins. Restyle a category here and its filter button on the live map shows the same icon, so visitors can match button to pin at a glance.

  • If your pins show numbers, the number sits on top of whatever icon and shape you've chosen — see Showing Numbers on Your Map's Markers.

  • Icons coming from your listings are styled in your workspace's listing properties rather than this collection's fields. Proxi will send you to the right place when that's the case.

  • Nothing here needs saving. Changes apply as you make them, and the preview is the real map.

  • Ensure the selected field matches the data you want to represent; choosing the wrong field can make markers misleading.

  • If using custom images, verify the image is clear and appropriately sized for map display.

  • Clustering can hide individual points if set too aggressively, so test the map at different zoom levels.

  • Spreading stacked pins is especially useful for shared addresses, but it may change how densely packed areas appear.

Tips for Efficiency

  • Use field-driven markers when you have many categories to avoid manually styling each point.

  • Keep a consistent color/shape system so users can quickly recognize categories.

  • Test marker size and clustering together, since changing one can affect readability of the other.

  • If your map has many overlapping points, enable clustering first, then fine-tune spread settings.

  • Save time by standardizing marker styles across similar maps or projects.


​

Did this answer your question?