Data Export
The Data Export page lets you request a structured export of your workspace's contacts, companies, and captured guests as a single ZIP file. Use it for backups, migrating to another system, or fulfilling a GDPR / Subject Access Request.
URL: /settings/data-export
Required permission: settings.tenant
How to get there
Go to Settings from the sidebar.
Open the Data export card.
How to request an export
Click Export all data in the top-right.
Confirm the prompt ("This will export all your workspace data. Continue?").
A background job starts building the archive. The page reloads with a new row showing
pendingorprocessing.
Export generation runs asynchronously because workspaces can be large. Expect a few seconds for a small tenant, up to a few minutes for tenants with gigabytes of files and years of history.
The export list
The page shows your 20 most recent exports with these columns:
| Column | Meaning |
|---|---|
| Status | pending (queued), processing (generating), completed (ready), or failed. |
| Requested | When you clicked Export. |
| Completed | When the archive was finished. |
| Size | File size of the resulting ZIP. |
| Expires | When the download link will stop working. |
Downloading
Once an export's status is completed, a Download link appears on the right-hand side. The file streams directly from storage (local disk or Azure Blob, depending on how your instance is configured).
Exports expire after a limited window (the exact expiry is shown per-row), after which the file is deleted from storage and cannot be recovered. Download promptly and store the ZIP somewhere durable (e.g. your own cloud storage, encrypted drive).
Failed exports
If an export fails, its row shows failed and the error message is displayed in the action column. Common causes:
Disk is full on the worker
Storage-backend credentials expired (production only)
A malformed record in one of the tables (rare, usually only after a botched import)
Request a new export. If it fails again, contact support via Support access.
What is in the export
The ZIP contains:
contacts.csv: your contact records.companies.csv: your company records.unifi_guests.csv: guests captured via the UniFi guest-WiFi flow.export-info.json: a small manifest recording the tenant ID, the time the export ran, the format version, and which models are included.
Each CSV is a standard RFC-4180 file you can open in a spreadsheet or re-import with standard tools.
Notes and gotchas
Exports can be large. A workspace with a long history can produce sizeable CSVs. Have enough local disk space before you download.
Nothing is reversible. The export is read-only: generating one doesn't modify anything in your workspace.
Don't email the ZIP. It contains personal data for every contact, company, and captured guest in your workspace. Store and transfer it securely.
Use the platform-level export for super admins. Platform admins can generate an export for any tenant via the platform console; this page is scoped to your own workspace.
The Trash feature is separate: see Trash for recovering individual deleted records.