HOA Units

Importing Contacts with Units and Addresses

If your homeowner roster already exists as a spreadsheet — names, emails, unit numbers, and addresses together — you can bring it all in at once from Contacts → Import, instead of adding units and assigning contacts by hand.

What gets detected

When you upload a file, it's scanned for a few kinds of columns:

  • Email and name — required, same as any contact import.
  • Unit / lot number — recognized from common headers like "Unit", "Lot", "Parcel", or "APN".
  • Address — recognized from headers like "Address", "Property Address", or "Situs Address".

If a unit or address column is found, you'll see a short prompt showing a few sample values and asking you to confirm before anything is imported. Nothing is added automatically — you always get the final say.

What happens to units during import

If you confirm the unit column, any unit label that doesn't already exist is created automatically, and the contact is linked to it. If a unit already has one contact and the import adds a second, no one's primary-contact status is changed by the import.

Matching rows to your existing units

Spreadsheets rarely write units exactly the way your unit list does, so the importer compares them loosely before creating anything new:

  • Street words and directions are treated as the same: 4100 Tuscany Oaks Dr matches 4100 Tuscany Oaks Drive, and N matches North.
  • Words like Unit, Apt, Lot, Suite and #, and leading zeros, are ignored: Unit 0101, #101 and 101 all match unit 101.
  • If your file has no unit column, the address is used instead — 4100 Tuscany Oaks Drive, Austin, TX still finds that home's unit.

A row is linked only when exactly one unit fits. If a value could belong to more than one unit — for example the house number 6400 on two different streets — the importer never guesses; that contact is left for you to assign from the Units page.

What happens to addresses during import

If you confirm the address column:

  • A unit with no address on file gets the imported address filled in automatically.
  • A unit that already has an address, and the import brings in the same address, does nothing — no duplicate work.
  • A unit that already has an address, and the import brings in a different one, is never overwritten automatically. Instead it's queued for your review.

Reviewing address conflicts

If any conflicts come up, you'll see a note in your import summary and a link to Units → Address Conflicts. That page shows each conflicting unit side by side — the address currently on file and the one from the import — so you can choose Keep Existing or Use Imported for each one, or resolve all of them at once with the bulk buttons at the top.

Tip: This is worth doing once, carefully, right after a board handoff or a big roster refresh — after that, adding a unit or two by hand from the Units page is usually faster than a full re-import.
Last updated: October 17, 2026