How to export your data from Customer.io

Customer.io lets you export people, objects, devices, and suppression data to CSV from the People page, and export a single person's full profile (attributes, events, deliveries, devices, relationships) as a set of JSON files from that person's profile page.

Formats: CSV, JSONPlan: Any plan (Builder, Essentials, Premium, Enterprise) - export features are not plan-gatedRole: Workspace access with permission to view People / Objects (not explicitly documented as owner-only)

✓ Verified against Customer.io's official documentation, September 2026

Step by step

  1. 1Bulk export: go to the People section of your workspace
  2. 2Click the 'Export to CSV' dropdown and choose 'All attributes' (all users, all attributes), 'Displayed attributes' (only the columns shown in the UI), or 'Choose attributes' (pick specific fields)
  3. 3Optionally add filters/segment conditions first to export only a subset of users, then pick which attributes to include
  4. 4Optionally check the box to also export a separate CSV of that person's relationships to objects (capped at 2 million relationships per export)
  5. 5Click Export to CSV - you'll get an email when it's ready, or find it on the Exports page (Configure data > More)
  6. 6Single-person export: open the individual Person page for the end-user, open the dropdown, and select 'Export Profile Data' to get that person's full record as JSON
  7. 7For objects: go to the object type in the left nav, open the object's detail page, click Options > 'Export Object data', optionally include relationship data, and confirm
  8. 8For the GDPR suppression list: go to Workspace Settings > Workspace Suppressions, click Export CSV under 'GDPR suppression list', then download from the Exports page

What the export includes

  • ✓People/user attributes (all, displayed, or chosen subset), plus the id attribute which is always included
  • ✓Duplicate-people and device lists (via 'Export other' on the People page)
  • ✓Object attributes and object-to-person relationships (CSV, capped at 2M relationships)
  • ✓For a single person: all attributes (attributes.json), all deliveries with full content (details.json), up to 25 devices (devices.json), all events (events.json.gz/events2.json.gz), delivery metrics (metrics.json), and relationships (relationships.json)
  • ✓GDPR suppression list as SHA-256-hashed identifiers (cio_id, id_sha256, email_sha256)

What it doesn't include

  • ✗Workspace configuration such as campaigns/workflows, message templates, segments definitions, or integration settings are not part of these people/object/person exports
  • ✗Filtering by email address is not supported for bulk people exports
  • ✗Disabled object types are excluded from the relationships CSV
  • ✗ESP-level email suppression list is separate from Customer.io's own GDPR suppression list and isn't included in that export

Before you start

  • ⚠Exports expire and are deleted from your workspace after 60 days - re-generate if you need them again
  • ⚠Bulk exports can take time depending on data volume; you're notified by email when ready, or check the Exports page
  • ⚠You cannot export more than 2 million relationships in one go for a person/user relationship export; the export fails and you must narrow the selection
  • ⚠Exports include all attribute data for selected profiles, including sensitive data - you must purge/redact before handing files to a third party
  • ⚠Object exports and relationship exports are also capped at 2 million relationships, and will fail if exceeded
  • ⚠Device data per person is limited to the 25 most recently used devices

Where to take your data

Free and cheaper tools that can take a Customer.io export. See all Customer.io alternatives →

Map the exported attributes.json / People CSV to Loops' contact fields and import via Loops' CSV contact import in the Audience section; recreate events/journeys manually since Loops doesn't ingest Customer.io's events.json format directly.

Convert the People 'All attributes' CSV export into Brevo's expected column format and import through Brevo's Contacts > Import feature, mapping custom attributes to Brevo contact attributes.

Exporting from Customer.io: common questions

Can I export all of my Customer.io data at once?+

There isn't a single 'export entire workspace' button in these docs. Instead, you export people (all attributes), objects, devices, duplicates, and suppression lists separately, or export one person's full record at a time.

What format is the Customer.io export in?+

Bulk people, object, device, and suppression exports are CSV files. A single person's full data export is a set of JSON files: attributes.json, details.json, devices.json, events.json.gz/events2.json.gz, metrics.json, and relationships.json.

How long do I have to download my export before it disappears?+

After 60 days, the export expires and Customer.io deletes it from your workspace, so download it and generate a new export if you need it again later.

Can I export just a segment of my users instead of everyone?+

Yes - on the People page you can add segment or attribute filters before exporting, then choose to export all attributes or a specific set for just that filtered group.

Is there a limit on how much relationship data I can export?+

Yes, you cannot export more than 2 million relationships in a single export; if you hit that limit the export fails and you need to select fewer objects or people and try again.

Does the export include the actual email/message content I've sent to customers?+

For a single-person export, yes - details.json contains that person's deliveries along with their full content, plus metrics.json with delivery stats and metadata.

Sources

This guide was written from Customer.io's own documentation and checked against it in September 2026. If a step has changed, the official page wins.