> For the complete documentation index, see [llms.txt](https://cranford-tech.gitbook.io/beautiful-maps-mapbox/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cranford-tech.gitbook.io/beautiful-maps-mapbox/loading-markers/adding-multiple-markers.md).

# Adding multiple markers

You can add a list of markers to your Mapbox Map using the '**Add List of Markers Map To Mapbox Map**' action. You can run this action page load - this way the markers will appear on the map almost instantly:

<figure><img src="/files/U2FXOoVl4UolsPgQ14o1" alt=""><figcaption></figcaption></figure>

If you don't choose a [custom icon](/beautiful-maps-mapbox/loading-markers/using-custom-icons.md), the default Mapbox marker icons will be used:

<figure><img src="/files/KgkY56v8dOhOR06aqbsK" alt=""><figcaption></figcaption></figure>

### Video tutorial

The below video tutorial shows how you can add a list of markers to a map with the 'Add List of Markers' action:

{% embed url="<https://www.youtube.com/watch?v=RRl133FBGlM>" %}

### **Add List of Markers action**

The 'Add List of Markers' action comes with the following fields:

<table><thead><tr><th>Field</th><th>Type</th><th width="300">Description</th></tr></thead><tbody><tr><td>Element</td><td>Dropdown</td><td>The Mapbox Map you're adding the markers to</td></tr><tr><td>Longitudes</td><td>number (list)</td><td>A list of longitude values</td></tr><tr><td>Latitudes</td><td>number (list)</td><td>A list of latitude values</td></tr><tr><td>Popup Content</td><td>text (list)</td><td>A list of text values that will be displayed in a popup that appears when the user clicks on a marker</td></tr><tr><td>Draggable</td><td>yes/no</td><td>If set to 'yes', the user will be able to drag the marker</td></tr><tr><td><strong>CUSTOM ICON INPUTS</strong></td><td></td><td></td></tr><tr><td>Icon Image (Single)</td><td>image</td><td>A custom image that will be used for the marker icons</td></tr><tr><td>Icon Image (Multiple)</td><td>image (list)</td><td>A list of images. Each image in the list will be used as the marker icon for the corresponding location.</td></tr><tr><td><strong>DIMENSIONS OF CUSTOM MARKERS</strong></td><td></td><td></td></tr><tr><td>Width</td><td>number</td><td>The width of the custom marker icon image</td></tr><tr><td>Height</td><td>number</td><td>The height of the custom marker icon image</td></tr><tr><td><strong>MARKERS WITH PRICES</strong></td><td></td><td></td></tr><tr><td>Prices</td><td>number (list)</td><td>A list of numbers. If added, the each maker will be a price (like in an Airbnb-style map)</td></tr><tr><td>Currency</td><td>text</td><td>You can specify the currency symbol to be used with the prices.</td></tr><tr><td><strong>OFFSET FOR MARKERS WITH SAME COORDINATES</strong></td><td></td><td></td></tr><tr><td>Latitude offset</td><td>number</td><td>The offset applied to markers that have exactly the same coordinates. Can be useful if you have a number of markers that appearing in the exact same location and you want to differentiate them from one another.</td></tr><tr><td><strong>UNIQUE IDs</strong></td><td></td><td></td></tr><tr><td>Unique IDs</td><td>text (list)</td><td>A list of texts that can be used to identify each marker. Useful if you're planning to allow users to add/remove markers at a later stage.</td></tr><tr><td><strong>HOVER MODE</strong></td><td></td><td></td></tr><tr><td>Icon Image (Single)</td><td>image</td><td>A custom image that will be used for the marker icons when they are hovered by the user. </td></tr><tr><td>Icon Image (Multiple)</td><td>image (list)</td><td>A list of images. Each image in the list will be used as the marker icon for the corresponding location when they are hovered by the user.</td></tr></tbody></table>