An adoption can only be recorded by signing an adoption contract on an approved application, so your organization needs at least one active adoption template. See Recording the adoption.
The list
Each template shows its name and version, what it is for, the conditions it is offered under (“Offered for: every animal”, for one with none), and its text. A template that has been signed says how many times. Tick Show retired to list retired templates too; they are marked Retired. Edit this template, under the contract chosen on an adoption application, opens this page at that template, ready to edit. A retired template is shown with the retired ones. It shows only to somebody with write on Animals.New template
Press New template.
Then set what it asks at signing (adoption templates only) and when it is offered, and press Create. Two templates cannot share both a name and a version.
For
A foster or surrender agreement fills
{{adopter_name}}, {{adopter_email}} and {{adopter_phone}} with the foster carer, or with the person who surrendered the animal, so one template wording does for all three kinds. Either can be signed in person or sent to sign from home, as an adoption contract can: there is no fee, media release or payment to choose on one.
Body
Write the agreement as you would a reply: bold, links, lists, headings, tables, pictures, a letterhead. Put merge fields where the details go, for example:I, {{signer_name}}, agree to adopt {{animal_name}} for {{fee}} on {{date}}.
Your organization’s name is not a merge field. Type it into the text.
Merge fields
Under the body, Merge fields: click to insert lists every merge field. Click one to insert it where the cursor is, spelled exactly. Hover over one to see what it fills in.
A detail that is simply missing, such as a co-applicant on an application without one, fills in as nothing.
Anything in double braces that is not one of these stays in the contract exactly as typed, and a contract with an unfilled placeholder cannot be signed. A misspelled merge field shows up when somebody tries to sign it. Insert fields by clicking them rather than typing.
Asked when it is signed
An adoption template can ask up to four things when it is signed on an approved application. Tick each one the template needs; the merge fields it fills are shown beside it, to put in your text.
What the signing form offers for each is described under What this contract asks. The answers are kept with the signed contract, as they were given.
Only the approved application asks these questions. A template that uses
{{payment_instructions}}, {{approved_by}} or {{completed_at}} cannot be signed from an adoption’s own Contract tab, because nothing fills them there. The media release is asked on both.{{payment_method}} fills in as nothing, and the others stay unfilled, so the contract cannot be signed on the application until the template is fixed; the preview names the field. The media release is the exception when the application already answered it.
Offered when
Which records a template is offered for. Leave everything blank to offer it for every record of its kind.A Transport template is asked one question instead of all of these: The run ends at. Everything below is about an animal or an adopter, and a transport run has neither - it has a date, a van, and a place at each end. See A transport agreement.
Add a condition on a field adds a test on a field of The animal’s or The adopter’s record:
- the animal’s status, species, breed, sex, size, altered, health status, intake source, name, medical flags, behavioral traits, microchip number or primary color;
- the adopter’s email, phone, roles, preferred contact or status;
- or a custom field…, named by its field key.
- On an approved application, only the templates offered for the chosen animals can be picked.
- On an adoption’s Contract tab, the offered templates come first, under Offered for this record, and the rest are still there under Other agreements.
A transport agreement
A Transport template is the paperwork that travels with a journey: the release a clinic wants before it treats an animal, the risks of anesthesia, what to do before and after a surgery. It covers every animal in the van at once.Signed by
There are two transport documents, and a template says which it is.
The second is the only one that can print what a journey costs, because services are chosen against a partner’s booking and never against your own animals on your own run. A run agreement naming
{{services}} would be a document with a hole in it.
A booking agreement is only ever shown to a partner whose booking qualifies for it. Your other templates are not theirs to read.
The run ends at
The one condition a transport agreement takes. Any transport offers it for every run; choosing a kind of place - A vet, A shelter or rescue, A home, A break stop, Somewhere else - offers it only for runs that end at that kind. This is how the surgery paperwork reaches the clinic runs and stays off the others. A narrowed agreement is still listed for any other run, marked as not offered, because the person picking one by hand knows things the rule does not.What it can name
Beside{{animal_names}}, {{animal_ids}} and {{microchip_numbers}}, which list every animal riding:
The addresses are the ones already on the run, which a saved place filled in: nobody retypes a clinic address onto an agreement, which is where it would be retyped wrong.
And on a booking agreement, which is the only place these exist:
There is no
{{transport_miles}}. The miles a booking was priced on are printed with each per-mile line, as they were when it was quoted: the run’s miles can change afterwards, and what was agreed does not.
A booking fills in {{animal_names}} and {{animal_count}} from the animals riding on it, but not {{animal_ids}}, {{microchip_numbers}}, {{transport_driver}} or {{transport_vehicle}}: those are yours, and the animals on a booking are the other rescue’s. The other rescue is shown that the document cannot be signed and that it is yours to fix.
An adoption’s fields - {{adopter_name}}, {{fee}}, {{animal_name}} on its own - do not fill in on a transport, so a template that uses them cannot be signed against a run. The preview names the field.
Editing a template
Press Edit on a template to change its body, what it asks and when it is offered, then Save. The name, version and kind cannot be changed. Editing does not change any contract already signed. Each signature keeps its own copy of the exact text that was agreed, with the template’s name and version as they were. A template that has been signed says so on its card, with how many times. Contracts signed after you save use the new text.Versions
The version is a label you choose, shown beside the name wherever a template is picked (“Adoption agreement · v2”) and kept on every contract signed from it. Because a template’s version cannot be changed, a new version of an agreement is a new template:1
Create the new version
Press New template and give it the same name with a new version, such as v2.
2
Retire the old one
Press Retire on the old version, so it is no longer offered.

