> For the complete documentation index, see [llms.txt](https://guides.fieldedgeapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.fieldedgeapp.com/product-tour-or-mobile-app/canvass/apartments-and-households.md).

# 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.