Skip to content

What the files contain

The data formats page describes every file and column of your exports, the open formats they use and what exports leave out.

Last reviewed November 2, 2026

The full export, the field outlines export and the CSV and Excel records exports each come with a README that explains their files and columns. The records PDF carries its notes inside, so it has no README. For the full reference, open the data formats page. The page is public, so you can send the link to an advisor, a developer or another provider who needs to read your files.

What the data formats page covers

  • Who can export and how to start an export.
  • The full export: every folder and file of the zip, with what each file holds, its format and its schema.
  • Exports of selections: the records and field outlines exports, with their formats.
  • Formats and standards: the open formats used, the units, how dates and times are written, and the identifiers.
  • Not included: what the full export leaves out, why, and how to get it another way.
  • Leaving and deleting your data: how to take your data with you and ask us to delete it. See also Leave Truleaf Fields.
  • Notes for developers, versions and changes to the formats, and who to contact.

The page also gives the exact hourly and daily export limits.

Read your files

Keep these points in mind when you open the files:

  • Areas are in hectares, and units are metric.
  • Times are in UTC. Columns named local_date give the date on the farm.
  • The CSV files of the records export and the full export use commas and a decimal point. Open them with a tool that reads CSV, and don't let a spreadsheet run formulas from a cell.
  • In a full export, the same data always gives the same files, so you can compare their checksums between exports.

Older versions

When the formats change, the page keeps the earlier versions. The manifest of a full export names the version it used, and you can pick that version on the page.

Still stuck?Email support.truleaf@truleaf.org