Data Export

Your farm data can be downloaded from the web dashboard at any time.

Export from Tools

  1. Open the farm.
  2. Choose Tools.
  3. Select Export.
  4. Choose JSON or CSV.
  5. Select Export Data.

The browser creates the file on your device.

JSON fields

The JSON file has these top-level fields:

  • farm: id, name, species, created_at, and updated_at;
  • animals: up to 10,000 active animals. Each entry has id, farm_id, metadata, is_active, created_at, updated_at, animal_identifiers, and groups;
  • records: up to 10,000 active records. Each entry has id, name, description, type, applied_at, is_active, created_at, updated_at, record_items, and files;
  • groups: up to 10,000 active groups. Each entry has id, farm_id, name, description, is_active, created_at, updated_at, and animals; and
  • exported_at: when the browser created the export.

Nested entries use these fields:

  • animal identifiers: id, animal_id, is_active, is_primary, type, value, created_at, and updated_at;
  • an animal's groups: id, farm_id, name, description, is_active, created_at, and updated_at;
  • record items: id, name, description, metadata, is_active, created_at, and updated_at;
  • record files: id, is_active, mime_type, name, size, url, created_at, and updated_at; and
  • a group's animals: id, farm_id, metadata, is_active, created_at, and updated_at.

The record entries do not include their animal or group associations. The top-level animal entries come from animal-list results rather than full animal profiles, so they do not include animal record history or animal files.

CSV fields

The CSV file has two sections:

  • ANIMALS with the columns ID, Name, Species, and Created At. Name is the animal's primary identifier value, or N/A when it has no primary identifier.
  • RECORDS with the columns ID, Name, Type, and Applied At.

The CSV does not include farm details, groups, non-primary animal identifiers, record items, files, or record-to-animal and record-to-group associations. Choose JSON when you need the additional fields listed above.

Current boundaries

  • The general export flow provides JSON and CSV, not PDF.
  • Each animal, record, and group collection is capped at 10,000 active entries.
  • Record entries omit their animal and group associations.
  • It exports the current farm rather than a selected animal or date range.
  • Farm Memory is not included in the current export.
  • Exporting does not change or delete the farm data in Ranch.Bot.

Keep downloaded files secure. They may contain identifiers, treatments, and other private farm information.

For import details, see Data Import. For export help, email support@ranch.bot.