Getting your animals into LAMB for the first time¶
Correction
An earlier version of this page claimed there was no manual "add animal" form anywhere in LAMB. That was
wrong — the app has a manual entry form for Denmark (AddAnimalScreenDk). This page has been corrected to
describe both paths.
There are two ways to get animals into LAMB, and today both are Denmark-only:
| Path | Best for | Where |
|---|---|---|
| Manual entry (Path A) | A few animals at a time, or one-off corrections | In the app |
| Spreadsheet import (Path B) | An entire flock at once | On the website |
Either path only registers adult animals (ewes and rams). Lambs always come in through birth registration, not through either of these two paths.
Path A: Register one animal at a time (in the app)¶
Denmark-only
This screen is only visible when the Fjárvís connection is disabled (AppConfig.fjarvisEnabled == false),
which today only applies to LAMB DK. In Iceland this screen doesn't exist — there, the animal database comes
from Fjárvís.
1 · Open "New animal"¶
Two places in the app open the same form:
- On the Dashboard, in the "Animals" tile, tap the + icon in the top corner.
- In the animals list (e.g. under "Ewes"), tap the + icon in the top right.
2 · Fill in the form¶
| Section | Fields |
|---|---|
| IDENTIFICATION | Animal number (pre-filled suggestion, editable), Name, Lamb number, Ear tag, Gender (Ewe (active) / Ewe (inactive) / Ram) |
| APPEARANCE | Color, Color markings |
| BIRTH | Birth date |
| ANCESTRY | Mother, Father (search fields matching already-registered animals) |
| FARM | Breeding status (Active/Inactive), Farm number and Operation number* (pre-filled from the settlement, editable) |
Fields marked * are required: animal number, gender, breeding status, farm number, and operation number.
Adult animals only
The gender dropdown only offers Ewe (active), Ewe (inactive), and Ram — no "lamb" option. Lambs are always registered through birth registration, not this form.
3 · Save¶
Tap "Create animal". The animal is saved directly to the database.
Editing or recording departure later¶
The same form reopens (now titled "Edit animal") when you open an animal's record and edit it. It then adds a "Departure / status" section — a reason (Died / Slaughtered / Sold / Other departure) and a date, for animals that have left the flock.
Path B: Import many at once (spreadsheet import on the website)¶
For an entire flock at once — e.g. when a new settlement is created — the "Import flock" screen
(/flock-import) is faster than registering each animal individually.
Also Denmark-only
On the Iceland site, the "Import animals" button on the Animals page points at this same page, but the link is
dead there, since the Icelandic site has no such page. As noted in
Getting started with LAMB, the DK website itself (dk.lambehf.com) isn't live yet either.
Before you start¶
- A settlement must already exist on the account before importing — otherwise you'll see the message "Create a settlement first before importing animals."
- Have your spreadsheet (Excel or CSV) of animals ready. Column headers can be almost anything — LAMB tries to recognize them automatically.
1 · Upload the file¶
On the "Import flock" screen, tap "Choose file" and pick an .xlsx, .xls, or .csv file. Only a small sample
is processed to detect the columns — the file stays in your browser.
2 · Map the columns¶
LAMB automatically guesses which column maps to which field. Review the mapping:
| Field | Required? |
|---|---|
| Ear tag | Yes — the only required field |
| Gender | No |
| Birth year | No |
| Birth month | No |
| Mother (ear tag) | No |
| Father (ear tag) | No |
| Name | No |
Fields marked "check" had low confidence in the automatic guess and deserve a second look.
About the automatic mapping
Mapping shows either "AI-mapped" or just "Auto-mapped" (heuristic, no AI). In today's DK build, the AI service isn't connected, so mapping runs on a simple keyword-matching guesser instead — it works reasonably well, but worse than with AI assistance. You can always correct any column manually.
3 · Review and confirm¶
The preview shows up to 30 rows, each with a status: ready, needs review, or rejected.
Important: only 'ready' rows get imported
When you tap "Import N animals", only rows marked "ready" get saved — rows marked "needs review" are not included in that pass, even though they weren't rejected. To bring them in, fix the underlying data or column mapping and upload the file again.
If an ear tag already exists in the settlement, the row is marked "update" and the animal is updated instead of being duplicated.
Error messages you may see¶
These currently appear verbatim in English in the "Notes" column, untranslated:
| Message | Meaning | Effect |
|---|---|---|
missing-tag |
No value in the ear-tag column | Row rejected |
invalid-tag-format |
The tag isn't 15 digits | Row rejected |
duplicate-in-file |
The same tag appears more than once in the file | The later row is rejected |
tag-prefix-not-DK |
The tag's country prefix doesn't match Denmark (208) | Needs review |
unrecognized-gender |
The gender column's value isn't recognized | Needs review |
birth-year-out-of-range |
Birth year isn't between 1990 and the current year | Needs review |
invalid-mother-tag / invalid-father-tag |
The parent's ear tag isn't a valid format | Needs review |
mother-is-self / father-is-self |
The parent's ear tag is the same as the animal's own | Needs review |
Based on lamb41/lib/screens/animals/add_animal_screen_dk.dart, lambsite/src/pages/FlockImport.tsx, and
lambsite/src/lib/flock-import/. See also Getting started with LAMB,
EID reader setup, and Connect an EID reader to the app.