Data Export
Think of an export as a backup of your data in a portable format — like exporting your contacts to a CSV before switching phones. Useful for migrations, compliance archives, offline analysis, or just keeping a copy of what's yours.
What you'll learn
- The kinds of data you can export
- How to create + download an export
- Format choices (JSON / CSV)
- Permissions: who can export what
What you can export
| Type | What it includes |
|---|---|
| Workspace | Everything in a workspace — members, projects, tags, files (metadata) |
| Project | A single project plus its resources |
| Conversations | Messages, channels, attachments metadata |
| Files | File metadata (and optionally the file contents themselves) |
| Tags | Your tag taxonomy + assignments |
| Groups | Group membership snapshot |
| Audit log | A range of audit events (typically for compliance) |
You can also bundle multiple types into a single export if you want, for example, "everything I own in this workspace."
Create an export
From the web app:
- Open Settings → Data Export → New Export.
- Pick the data types you want (one or many).
- Pick the format — JSON for structured, lossless data; CSV when you want to open it in a spreadsheet.
- (Optional) Restrict to a date range.
- Click Create export.
You'll see the export move through these stages:
Queued → Running → Ready → Downloaded
Big exports run in the background. You'll get a notification when it's ready.
Download the export
When the status hits Ready:
- Open the export from Settings → Data Export.
- Click Download. You'll get a single archive (
.zipfor multi-type, or a single file for one type). - The download link expires after 7 days. Re-run the export if you need it again later.
Format choices
| Format | Use when |
|---|---|
| JSON | You're migrating to another tool, archiving for compliance, or running scripts |
| CSV | You want to open it in Excel / Sheets / a data tool |
JSON exports preserve every field (including nested objects, timestamps, IDs). CSV flattens nested data and is lossier.
Permissions: who can export what
Exports always respect your existing permissions — you can only export data you can already see.
- Workspace members can export their own activity + anything they own
- Workspace admins can export workspace-wide data
- Tenant admins can export tenant-wide data (every workspace)
- Audit log exports require an extra permission (
audit.export) — usually held by compliance / security roles
If a teammate exports a workspace, every member of that workspace sees an entry in the audit log noting who did it, when, and what scope.
Privacy + retention
Exports include only the data you have permission to see, never other tenants' data, and never secrets or passwords (those are never persisted in a recoverable form to begin with).
We keep the downloadable export file for 7 days then delete it. The export record (who ran it, when, what scope) stays in the audit log per your tenant's retention policy.
Troubleshooting
| Symptom | What to try |
|---|---|
| Export stuck on Queued for more than 10 min | Check the status page. Re-create if the queue is healthy. |
| Failed status with no error | Open the export and look at the Last error field. Most common cause: permission change mid-run. |
| Download link returns 403 | Link expired (7 days). Re-create the export. |
| File is much smaller than expected | A date-range filter or scope restriction may be in effect. Check the export's settings. |