> For the complete documentation index, see [llms.txt](https://docs.gridmate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gridmate.io/product-tour/maps/map-list.md).

# Map List

Map many records of any object, filter them in a list and run actions.

GridMate offers a convenient feature that allows users to map multiple records for any object (Standard or Custom). The **GM - Map List** component provides and list view to filter records and take mass/record actions.

In this tutorial, we will show how to configure The **GM** - **Map List** component to map the accounts based on the billing address**.**

{% embed url="<https://youtu.be/uoi_A98nTeU>" %}

To make sure having only geocoded accounts, we used the filter below:

```json
{
    "BillingLatitude": {
        "operator": "!=",
        "value": null
    }
}
```

The **Marker Coloring** configuration used in this demo is based on the account type. See below:

```json
[
    {
        "color": "#75c452",
        "exp": {
            "Type": {
                "operator": "=",
                "value": "Customer"
            }
        }
    },
    {
        "color": "#f2b016",
        "exp": {
            "Type": {
                "operator": "=",
                "value": "Prospect"
            }
        }
    },
    {
        "color": "#4d94ff",
        "exp": {
            "Type": {
                "operator": "=",
                "value": "Partner"
            }
        }
    },
    {
        "color": "#663399",
        "exp": {
            "Type": {
                "operator": "=",
                "value": "Reseller"
            }
        }
    }
]
```

For search around, we use GeoApify with maximum radius of 500km. See below:

```json
{
    "unit": "km",
    "distance": "500",
    "autoComplete": {
        "autoCompleteHandler": "GeoApifyAutoCompleteHandler"
    }
}
```

{% hint style="info" %}
The around search unit could be **km** or **mi**.
{% endhint %}

{% hint style="info" %}
[Mass/Record action](/advanced-guides/grid-actions/actions-library.md) Global can be configured based on requirement. We support quick actions or call a flow actions.
{% endhint %}

Below is a quick demo of **Map Explorer** where the user can see visualize accounts, search, filter and navigate around without leaving the record page. We can also edit the records and trigger quick actions like mass assign based on the trigger.

{% embed url="<https://youtu.be/C8Bpq__YKSM>" %}

## Custom Icon (SVG)

To enable the **Custom Icon** feature, simply navigate to **Setup** and follow these steps:

{% stepper %}
{% step %}

### Create a static resource

Go to **Static Resources** and click **New**.
{% endstep %}

{% step %}

### Name the resource

Set a **Name** for your resource.
{% endstep %}

{% step %}

### Upload the SVG

Upload your **SVG file**.
{% endstep %}

{% step %}

### Set the cache control

Set the cache control to **Public**.
{% endstep %}

{% step %}

### Save

Click **Save**.
{% endstep %}
{% endstepper %}

<figure><img src="https://4046919449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MEsSbGy_U_OhthKUpxu%2Fuploads%2Fkvybu0MCrc0z669kE3lH%2FScreenshot%202026-02-25%20at%2018.28.29.png?alt=media&amp;token=a05a801e-5d6e-43eb-8caa-9f45128ec13e" alt=""><figcaption></figcaption></figure>

Below is a step-by-step guide to configure the **Custom Icon** feature 👇

{% embed url="<https://youtu.be/gT88X8-XF1I>" %}

## Next steps

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>GM - Map List</strong></td><td>Every property of the component.</td><td><a href="/package-reference/components-library/gm-map-list.md">GM - Map List</a></td></tr><tr><td><strong>Map List - Search Around</strong></td><td>Find configured points of interest within a radius of any location on a Map List.</td><td><a href="/advanced-guides/other-components/map-list-search-around.md">Map List - Search Around</a></td></tr><tr><td><strong>Map List - Marker Clusters</strong></td><td>Group nearby map markers into clusters on a Map List.</td><td><a href="/advanced-guides/other-components/map-list-marker-clusters.md">Map List - Marker Clusters</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gridmate.io/product-tour/maps/map-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.