> 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

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.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.chirpwireless.io/settings/locations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.