# Apartments & Multi-Unit Buildings

FieldEdge groups contacts at the same address into a single building when there are unit numbers — letting you canvass apartments, condos, and townhouse complexes one unit/apartment at a time.

## What makes a building an apartment

A group of contacts at the same address becomes an **apartment** when:

* At least one contact has a **unit number** in their address, AND
* They share the same lat/lng coordinates

If contacts share an address with **no unit numbers**, they remain a single household with multiple residents (not an apartment).

{% hint style="info" %}
Grouping happens in the app when your walk list loads — not in NationBuilder. If two contacts at the same address aren't being grouped the way you expect, check that they have matching addresses and unit numbers in NationBuilder.
{% endhint %}

## How the canvass flow differs

* **Single household:** tapping the pin or list row opens directly into the [Household View](/product-tour-or-mobile-app/canvass/household-view.md) showing the residents.
* **Apartment:** tapping the pin or row first shows the building, with each unit/apartment listed inside it. Tap a unit/apartment to see its residents.

## Apartment pins on the map

Apartments use a building/apartment icon to distinguish them from single-household house icons. After canvassing, status pins (Completed, Left Message, No Answer, Blocked, Skipped) are the same icons used for single households — see [Map View → Pins](/product-tour-or-mobile-app/canvass/map-view.md#pins) for the full breakdown.

## Adding a new unit/apartment

When [adding a new household](/product-tour-or-mobile-app/canvass/adding-people-and-households.md#adding-a-household) in an apartment, there's an important constraint: the **unit number field only becomes editable once you've selected the building address** via Google Places autocomplete. You can't type a unit number first and pick the building later.

The flow:

1. Tap to add a new household (button or tap-on-map)
2. Search for and select the building's address
3. The unit number field becomes editable — fill it in
4. Complete the rest of the form and save

When you then [add a person](/product-tour-or-mobile-app/canvass/adding-people-and-households.md#adding-a-person-to-an-existing-household) to that unit/apartment, the unit number is locked — they inherit it from the household.

## Tracking completion

Each unit/apartment tracks its own canvass status independently. You can complete some units/apartments of a building and skip others. The apartment pin on the map reflects the overall outcome across all its units/apartments.


---

# Agent Instructions: 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:

```
GET https://guides.fieldedgeapp.com/product-tour-or-mobile-app/canvass/apartments-and-households.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.