A unit is the foundation for billing, documents, violations and communication, so adding your units is the first big step after setting up your community. Add a handful by hand, or bring the whole neighborhood in at once with a CSV file.
1. Choose How to Add Units
- A few units: add them manually. See Adding a New Unit.
- Most communities: import a CSV file and add everything in one go. Follow the steps below.
Click Units in the main navigation. The Add Unit button adds one unit, and Import starts a bulk import.
2. Prepare Your CSV File
- In Excel or Google Sheets, put one unit per row, and save or export the file as a .csv.
- Include a header row with a name for each column. You will match your columns to Perfect HOA’s fields in a later step, so the exact names do not matter.
- Every row needs a street address, city, state and zip. A unit title, a second address line, a starting balance and the date of that balance are optional.
Tip: Before uploading, delete blank rows at the bottom, make sure no address appears twice, and write street names the same way throughout (always “St.” or always “Street”).
3. Upload the File
Click Import on the Units page. On Step 1: Upload CSV, drag your file into the box or click to browse, then click Upload. The file must end in .csv.
4. Map Your Columns and Import
On Step 2, each Perfect HOA field has a dropdown that lists the columns in your file (– Select a Column –). Choose the matching column for each one:
- Required (marked with a red asterisk): address1, city, state and zip. The import will not continue until all four are matched.
- Optional: title, address2, balance and balanceOfDate (the starting balance and its date).
- Tick Download Google Streetview photos for the units if you want a photo added to each unit.
Submit the mapping. Your file is queued for import and you will be notified when it is complete, then your units appear in the Units list.
Note: Importing a very large file takes a little while because it runs in the background. You can keep working in Perfect HOA while it finishes.
5. Check Your Units and Add Owners
Open the Units list and spot-check a few records. Next, add owners and contacts so you can invoice and message them. See Unit Management & Bulk Importing for managing units after the import.