> 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/settings/locations.md).

# Rooms and Locations

Organize sensors by room and area to mirror your home, making dashboards and readings easier to find.

Rooms and locations let you organize your sensors the way your home is actually laid out. Create a structure that mirrors your living space -- floors, rooms, outdoor areas, a detached garage, a greenhouse -- and assign sensors to the spots where they physically sit. This makes it much easier to filter dashboards, find specific readings, and keep track of where everything is.

## Getting There

Go to **Settings** > **Locations** in the sidebar. The page heading reads **Location settings** with the note "Manage your locations."

## Creating a Location

1. Click **Add location** in the top-right corner.
2. Enter a **Name** for the location (for example, "Ground Floor", "Garden", or "Attic").
3. Click **Save**.

The location appears in the list below. If this is your first one, it replaces the "You don't have locations yet" placeholder.

## Working with Locations

Each location in the list shows its name as an editable text field -- change it directly and click away to save. A trash icon lets you delete it after confirmation, and a chevron expands the entry to reveal more options.

### Setting a Position

Expand a location to see the search/coordinates input. Type an address or enter latitude and longitude directly. This ties the location to a point on the map, so sensors assigned here appear in the right spot on map views.

### Adding Sub-Locations

Sub-locations let you build a hierarchy inside a location -- rooms within a floor, beds within a garden, shelves within a cellar.

1. Expand the parent location.
2. Click the **+** button below the sub-location list.
3. Enter a name (for example, "Kitchen", "Bedroom", "Herb Garden").
4. Click **Save**.

Sub-locations appear indented under their parent and can be renamed or deleted independently.

### Toggling Sub-Location Visibility

The **Show sub-locations** toggle at the top of the page controls whether sub-locations are displayed. Turn it off for a simplified overview of just your top-level areas. It defaults to on.

## Home Layout Examples

| Home setup             | How to structure it                                                                                 |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| Two-story house        | Locations: Ground Floor, First Floor, Basement. Sub-locations: individual rooms.                    |
| Apartment with balcony | Locations: Apartment, Balcony. Sub-locations: Living Room, Kitchen, Bedroom.                        |
| Home with garden       | Locations: House, Garden. Sub-locations: rooms inside, zones outside (Vegetable Patch, Greenhouse). |

Once your locations are in place, you can assign sensors to them and use the structure to filter dashboards and map views.
