> For the complete documentation index, see [llms.txt](https://docs.chirpwireless.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chirpwireless.io/dashboards/maps-and-device-placement.md).

# Maps and Device Placement

See where each sensor sits in your home on an interactive map and assign a room to put it on the map.

When you have sensors spread around your home — in the kitchen, the garden, the garage — it helps to see where each one actually is. Chirp shows your sensor locations on an interactive map, so you always know which device is where without checking labels or room assignments.

## Where to find the map

The map appears on each sensor's detail page:

1. Tap **Devices** in the sidebar.
2. Tap a sensor to open its detail page.
3. The **Overview** tab is selected by default. The map appears in a card below the sensor's status information.

If the sensor has a location assigned, you'll see a marker on the map showing its position. A **location bar** above the map shows the sensor's room and sub-location (for example, "Living Room, Window side").

## When no location is set

If you haven't assigned a location to the sensor yet, the map area shows a placeholder:

* The text reads **"Your device location is empty"** and **"data will be available here soon"**.
* An **"Add device location"** button appears below. Tapping it takes you to the sensor's **Settings** tab, where you can pick a room from the rooms you've set up.

The button only appears if you have permission to edit the sensor.

## What the map can do

The map view gives you:

* **Pan and zoom** — Explore the area around your sensor's location.
* **Fullscreen** — Expand the map for a better look on any screen.
* **Responsive sizing** — On your phone, the map adjusts to fit comfortably.
* **Light and dark mode** — The map matches your Chirp theme.

## Setting a sensor's location

To put a sensor on the map:

1. Tap **"Add device location"** on the map placeholder, or go directly to the sensor's **Settings** tab.
2. Choose a room from the rooms you've created (rooms are set up in [Rooms](https://docs.chirpwireless.io/devices/rooms.md)).
3. Save. The map on the Overview tab now shows your sensor's position.

## GPS trackers

If you have a GPS tracker device (for a vehicle, pet, or bike), the same map area can show where the tracker has been — not just where it is now. This location history feature is covered in [Tracking What Matters](https://docs.chirpwireless.io/dashboards/tracking-what-matters.md), since it involves additional controls like date selection and route details that are specific to tracker devices.

## What's next

* [Rooms](https://docs.chirpwireless.io/devices/rooms.md) — Set up the room structure that feeds into device locations.
* [Tracking What Matters](https://docs.chirpwireless.io/dashboards/tracking-what-matters.md) — Location history for GPS tracker devices.
* [Sensor Details](https://docs.chirpwireless.io/devices/sensor-details.md) — View and edit everything about a sensor.
