Skip to main content
Contract templates holds the agreements people sign: the adoption contract, a foster agreement, a surrender form. A template is the text a contract is made from. The signed contracts themselves live on the records they were signed on. Find it under Settings → Operations & forms → Contract templates, or type “Contract templates” in the search palette. Anyone whose role can See Animals can read the templates. Writing, editing and retiring them needs Change on Animals.
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.
Tick the ask for each of these merge fields your text uses. Left unticked, {{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.
Each test is is, is not, contains, is filled in, is empty, is more than or is less than, with a value where the test needs one. Every condition must hold for the template to be offered.
  • 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.
When two adoption templates are both offered, the one with conditions is listed above the one without, so a template for a particular kind of animal comes before your standard one.

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.
Contracts signed on the old version keep its text and still say which version they were.

Retiring a template

Retire stops a template being offered for signing. It is kept, so every contract signed from it still names it, and Show retired lists it.
Retiring happens at once, with no question first, and the app has no way to bring a retired template back. Make a new template instead.
Templates are never deleted.