---
module: devices.map
title: Map
tab: Customer
order: 10
audience: customer
---

See every ATM in your fleet on a single map, colour-coded by live status. Use it to spot problems by location at a glance and jump straight to the ATM or incident that needs attention.

## 🗺️ What you're looking at
Each pin is an ATM, placed at its address and coloured by its current state:

- 🟢 **Online** — in service and healthy
- 🔴 **Offline** — down, in maintenance, or inactive
- 🟠 **Out of Cash / Open Incident** — needs attention
- 🔵 **Supervisor Mode** — currently in supervisor mode

When several ATMs sit at the same location, they share one pin with a small **count badge**, and the pin takes the colour of the most serious ATM in that group. The bar above the map shows how many ATMs are currently displayed out of your total.

## 🔍 Filter the map
Narrow the map down to what you care about:

1. **Status** — show only Online, Offline, Out of Cash, Open Incident, or Supervisor Mode ATMs (each option shows a live count).
2. **Incident Type** — show only ATMs with a specific type of open incident.
3. **Group** — show only ATMs in one of your ATM groups.

Active filters appear as tags below the controls. Remove one with its **×**, or click **Clear all** to reset.

## 💾 Save filter presets
1. Set the filters you use often.
2. Click **Save preset**, give it a name, and click **Save**.
3. Your presets appear in the **Saved** bar — click one to reapply those filters instantly, or use its **×** to delete it.

## 📍 Open an ATM or incident
1. Click any pin to open its popup.
2. The popup lists the ATM ID, location, address, current status, agent connection, and any open incidents.
3. Click the **ATM ID** to open the full ATM detail, or click an **incident tag** to open that incident.

## 🔄 Auto-refresh
The map refreshes on its own and shows a countdown to the next update. Toggle **Auto-refresh** off if you'd rather it hold still.

> **Good to know:** ATMs without a latitude and longitude can't be placed on the map. When some are missing coordinates, a banner shows how many — click **View in ATM List** to find them and add their location in ATM properties.
