Help Center Properties & people

Authorized members; tenant imports require administrator or manager access

CSV imports: prepare, upload & check results

Bring in building, apartment and tenant lists in the correct order.

Guide translation: draft, needs human review

Prepare the file

  1. Step 1: Import buildings first, apartments second, and tenants last. Each later file depends on the earlier records.

  2. Step 2: Open the matching import dialog and select Download template. Keep its header names unchanged.

  3. Step 3: Use one record per row. Match building names and unit identifiers consistently, and keep unit numbers as text when leading zeros matter.

  4. Step 4: Save the spreadsheet as CSV. Keep tenant contact and consent files private.

Template fields

Buildings: name, address, borough, bin, bbl, units_count, year_built, equipment.

Apartments: building, unit, floor, bedrooms.

Tenants: building, unit, full_name, email, phone, email_consent, consent_evidence.

Import and validate

  1. Step 1: Select Choose CSV file in the matching import dialog.

  2. Step 2: Read the result and any row errors. Do not assume every row saved because the file was accepted.

  3. Step 3: Correct missing buildings, units, required values or consent evidence. Check the affected records before retrying.

  4. Step 4: Open the list afterward and compare a sample of names, locations and totals against your original file.

If an import fails

Check permissions and the selected organization first. Avoid repeated clicks while a request is running. Tenant import retries have safeguards against matching duplicate records, but do not treat every import as an unrestricted merge or assume building imports are deduplicated automatically.

Related guides

All guides