Skip to content

Bulk-importing your portfolio data via CSV

Go to Organization > Imports to bring in data in bulk rather than creating records one at a time.

On the Single CSV tab, choose a resource type — property, unit, tenant, lease, and so on. Click Download template if you want a starting spreadsheet with the right columns already in place.

The New import card with the Resource picker choosing which kind of record the CSV contains, and a source namespace field.

Upload your CSV. Vespy tries to auto-map your columns to the right fields; review the mapping and adjust any dropdown that guessed wrong. Fields marked with * are required.

The column mapping step, pairing each field Vespy expects with a column from the uploaded CSV.

Click Upload and validate. You’ll get a preview breaking down how many rows will be created, updated, left unchanged, merged as duplicates, or failed — nothing is imported yet at this point. If anything failed, Download failures gives you a CSV of just the problem rows so you can fix and re-upload them.

Once the preview looks right, click Start import. The page checks in automatically every couple of seconds while it’s validating, queued, or processing, so you can watch it finish without refreshing.

The Import history table lists everything you’ve imported before — click a row to reload its results if you need to double-check what happened.

The Import history card, where past import runs and their outcomes are listed.