# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cranford-tech.gitbook.io/beautiful-maps-mapbox/loading-markers/adding-multiple-markers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.