Help · Your team and your account
Can I export all my data?
Your organization's data is yours to take with you at any time. The Owner and the Administrators can download everything the organization holds; they and the Operations admins can download everything it holds about one person. Both downloads keep working while an account is read-only, and while it is closed, right up to the day it is deleted.
Download everything
- Open Settings, Export and close account, at https://app.contactroll.com/settings/export.
- Under Take your data with you, press Download everything.
- ContactRoll gathers the records in parts, then fetches the files, and shows how far it has got. The zip is saved only once every part and every file has arrived, so what you get is always complete. If one part or one file can't be fetched, nothing is saved, and ContactRoll says which one beside the button. Press it again.
You get one zip file, named after your organization and the day. Inside it:
- export.json: every record your organization holds, in one file, exactly as ContactRoll keeps it. That includes every contact, company, case, message, internal note, task, deal, saved reply, marketing record, team member and the audit log.
- data/: one CSV file for each kind of record, to open in a spreadsheet. A cell that begins with =, +, -, @ or a tab has an apostrophe put in front of it, so the spreadsheet doesn't run it as a formula. export.json holds every value exactly.
- files/: every file your organization stored: the files customers attached, documents on records, your media library, video and pictures made for your marketing, and the pictures in approved emails.
- manifest.json: a list of every file in the zip, with the name a person gave it, its size and its SHA-256 fingerprint, so you can check each one arrived whole.
Your organization's own settings, such as its time zone, currency and invoice numbering, are in export.json under organization_settings.
What the zip leaves out, and says so
The manifest names everything the zip doesn't carry, and why:
- Files not in this zip. A document limited to roles that don't include yours is named, not downloaded: someone whose role it names can download it from its record. A file still being uploaded when you pressed is named too.
- Very large exports. One zip holds up to 60,000 files and 2 GB. Files past that are named in the manifest, and you can download each one from the lists below the button.
- Tables left out. A few kinds of record are never exported, and the manifest says why for each: passwords, keys and tokens for the services you connected (the connections themselves are exported), sign-ins to other services while they are happening, ContactRoll's own working records such as queues and counters, and prayer and care requests, which only the roles each request names can read.
If your organization records calls, the export names each recording: when it was made, how long it is, and Twilio's own name for it. The recordings themselves are kept in your own Twilio account.
The files one at a time
Below Download everything, the same page lists the files customers attached, the documents on records and your media library. Press a file's name to download just that file. You don't need these if the zip has everything, but they're there if you want one file, or if your export is larger than one zip holds.
Everything about one person
When someone asks to see what your organization holds about them, the Owner, an Administrator or an Operations admin can download it as one file.
- Open the person's contact page.
- Find What this organization holds about them.
- Press Download it as one file.
The file holds their record and their company, every address and number they have had with you, the notes and comments about them, their cases with every reply and internal note, their deals, their calls (and who listened to a recording), tasks, the log of what happened to them, consent, unsubscribes, topic and frequency choices, lists, segments and sequences, sign-ups, survey answers, sends and clicks, billing requests, and what flows and webhooks did about them.
The file includes your team's internal notes about them, because they are your organization's words. Read it through before you send it, and decide what to hand over.
Who can export
- Download everything and the files one at a time are for the Owner and the Administrators; the one-person export is for them and the Operations admins.
- The Roles page lists both downloads among the sensitive permissions and shows who holds each one today.
Before you close your account
Download everything is directly above Close this account, so you can take your data first. See "Close your account" for what closing does, and when.
Didn’t find what you needed? Ask us on the help center: the form is at the foot of its page, and the people who build ContactRoll answer.