For the complete documentation index, see llms.txt. This page is also available as Markdown.

Apartments & Multi-Unit Buildings

How FieldEdge handles multi-unit buildings during a canvass

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

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.

How the canvass flow differs

  • Single household: tapping the pin or list row opens directly into the Household View 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 for the full breakdown.

Adding a new unit/apartment

When adding a new 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 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.

Last updated