Exports is where you start an export, follow it and download its files. You can export your records, your field outlines or the whole workspace, in open formats. Exports are free.
Who can export
- Owners, admins and editors can export records and field outlines.
- Owners and admins can also export the whole workspace with Export everything. See Export everything.
- Contributors and viewers can't export. They don't see Exports in the menu or the export buttons on other screens. If they open the export centre from a link, they see
Your role can't do this
Exports are included in every plan. They keep working when a workspace is read-only, for example after a trial ends or while a payment is missing.
Open the export centre
- In the menu, select Exports. On a phone, it is under More in the bottom bar.
- Or go straight to the export centre.
You see the list of exports, newest first. Under the list, Export from where you are offers the common exports, and owners and admins see Need everything?, the card for the full export.
The first time, the list is empty and says No exports yet.
Start a new export
- Select New export. The New export window opens at its first step, What.
- Choose what to export: All records or Field outlines. Each choice lists the formats it offers. Select Next.
- In Options, choose the Scope, the Period (for records), the Format and the README language. Select Next.
- Summary shows your choices and how many rows the export will hold. To fix something, select Change.
- Select Start.
The window shows the progress. We'll let you know when it's ready. You can close this. When the files are ready, the window says Your export is ready and offers Download. To see everything about the export, select Open details.
The details of each kind are in Export your records and Export field outlines.
Export from the screen you are on
Screens that show your data have their own Export button. It opens the same window, filled in with what the screen shows:
| Screen | Button | What it exports |
|---|---|---|
| Overview (farm workspaces) | Export | A menu with Export records, Export fields and All exports. With a farm chosen, the export covers that farm. |
| Fields | Export fields | The field outlines of the farm, tags or fields the table is filtered to. |
| Field logbook | Export records | Your records. If the logbook is filtered by date, the export uses those dates. |
| Usage, tab Fields | Export CSV | The field outlines as a CSV file. |
You can still change every choice in the window before you start.
Find an export in the list
Each row shows the export, its Scope, who asked for it, its Status, its Size and the date in Available until.
- Owners and admins see everyone's exports. Use Show to see only yours.
- Editors see only their own exports.
- Narrow the list with Kind and Status. Clear filters shows everything again.
In an advisory or cooperative workspace, the All mine tab lists your exports in every workspace you work in. This workspace shows only the current workspace.
Follow an export and download it
Select an export to open its page.
- While it runs, the page shows its steps: Collecting data, Writing files, Packing the files and Saving the files. You can leave the page. The export keeps going.
- When it is ready, Files lists each file with its size. Select Download.
- What's inside says what the files hold, and Details shows the choices behind the export.
The app tells you when an export is ready or has failed. You also get an email when an export fails, when it took a while, or when a full export is ready. Emails go only to a confirmed address. Without one, you still see the notice in the app. See Emails we send.
Each time you select Download, you get a fresh download link that works for a short time only. To share an export, share the file you downloaded, not the link.
On a phone, a large file shows a warning first. Download it on Wi-Fi or a computer, or select Download anyway.
To check that a file arrived whole, compare it with the value under Checksums (SHA-256).
Cancel an export or delete its files
You can do this for your own exports. Owners and admins can do it for everyone's.
- Cancel an export that is still running: select Cancel export, then confirm with Cancel export. Files written so far are deleted.
- Delete the files of a finished export now: select Delete files now, then Delete files. You can make the export again later with current data.
How long files are kept
Files are kept for a limited time. Each export's page shows the date, and so does the list under Available until. After that date, the files are deleted and the export shows Expired.
To get the files again, open the export and select Generate again. Generates a new export with today's data.
Make an export again
- Failed: select Try again.
- Expired: select Generate again.
- Cancelled: select Reuse these settings to open the window with the same choices. Only the person who started the export sees this. For a cancelled full export, select Try again.
Limits
Exports are free. A few limits protect the service:
- You can run only a few of your own exports at the same time in a workspace. At that point, the New export window says how many of your exports are in progress and asks you to wait for one to finish. If you start the export again from its page instead, you see
Too many exports in progress
- A workspace can start a limited number of exports each hour, and a limited number of full exports each day. When you reach a limit, the window tells you when you can start another one.
- A very large export can't start. You see
This export is too large
Common problems
- You don't see Exports. Your role can't export. Ask an owner or admin to export for you, or to change your role.
- The download doesn't start, or says
This export has expired
The files were deleted. Select Generate again. - You're offline. Exports need a connection. Exports need a connection. Try again when you are back online.
- This export failed Select Try again. If it fails again, write to support.truleaf@truleaf.org and include the Export ID from Details.
Related pages
Still stuck?Email support.truleaf@truleaf.org