> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rescueconsole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adoption settings

> Adoption returns, adoption holds, the documents that go home, desk tablets, application stages and decision reasons.

These settings shape an adoption, from the stages of its application to the documents that go home with the animal. Most are under **Settings → Animal management**; **Application stages** and **Decision reasons** are under **Settings → Operations & forms**. Roles are explained in [Team roles](https://docs.rescueconsole.com/settings/team.md#team-roles).

## Adoption returns

**Settings → Animal management → Adoption returns** sets how long after its adoption an animal brought back is an **adoption return**. Brought back later, it arrives as an **owner surrender**, and [Shelter Animals Count](https://docs.rescueconsole.com/animals/national-reporting.md) counts the two apart. It is 30 days unless you change it under **An adoption return, within**. A reversed adoption records its arrival this way, and **Record arrival** on the animal chooses this way for you. Tick **Off** for every adoption undone to be a return and nothing chosen. Changing it needs **Configure** on Animals.

Below it, **Warn about a person who has returned or surrendered** is a number of animals, 1 to 50. A person's record, and any application of theirs, always says how many animals they have [returned and surrendered](https://docs.rescueconsole.com/people/record.md#returns-and-surrenders); at or past this many, the two together, it says so as a warning. Empty is no warning, as it starts. It has a **Save** of its own, and saving it leaves the return window as it is.

## Adoption holds

**Settings → Animal management → Adoption holds** is how long an animal is [held for a person](https://docs.rescueconsole.com/animals/adoptions.md#holding-an-animal-for-someone) unless the hold says otherwise, and its fee.

| Setting | What it does |
| - | - |
| **Hold an animal for** | Hours. 48 unless you change it. |
| **No limit: a hold lasts until somebody ends it** | Holds end only when released, or when the person adopts. |
| **Hold fee** | In dollars, or empty for none. It is taken on Sales as an adoption deposit from the person. |
| **Keep the fee when they adopt, rather than taking it off the adoption fee** | Unticked, the fee comes off the adoption fee; ticked, it is kept as yours. |

Press **Save**. Changing these needs **Configure** on Animals.

## Documents that go home

**Settings → Animal management → Documents that go home** is your own documents for the people your animals go home with: your vets, training tips, a microchip registry's sign-up. Under **Add a document**:

**1. Name it**

Give it a **Name**.

**2. Say what it is for, if you like**

Say **What it is for** if you like.

**3. Choose its file**

Choose its file (a PDF, a picture or a Word document).

**4. Add it**

Press **Add**.

Each document has a row for each kind of event, **An adoption**, **A surrender**, **A return to owner** and **A transfer out**, with two ticks:

| Tick | What it does |
| - | - |
| **Emailed** | With an adoption, it is linked in the [receipt email](https://docs.rescueconsole.com/animals/finalizing-an-adoption.md#emailing-the-receipt), ticked to start with. A new document is emailed with an adoption. |
| **Printed** | It is listed under **To print** where that event is recorded: the adoption's receipt, an owner surrender's agreement, and the record of an animal returned to its owner or transferred out. |

Under the ticks, a line says who the document is for, such as **For Cat, every age** or **For every species, every age**. Open it to tick the **Species** and the **Age groups** it is for: your own [age groups](https://docs.rescueconsole.com/settings/pet-configuration.md#age-groups), each name once. None ticked is every one. A document narrowed to cats, or to kittens, is offered only with a cat, or a cat in that age group: in the receipt email, on My portal, and where the event is recorded. An animal with no date of birth is in no age group, so it is offered only the documents for every age.

Both are only where it starts: each time, the receipt's email can leave one out or add another, and anything listed can be opened and printed or not. Untick **Offered** to stop using a document without deleting it; the trash button deletes it. A link to a document opens it for whoever has the link, as it is meant to go home with anybody, and a document switched off or deleted no longer opens. Changing them needs **Configure** on Animals.

## Desk tablets

**Settings → Animal management → Desk tablets** pairs a tablet at your adoption desk, so an adoption contract can be [handed to it](https://docs.rescueconsole.com/animals/application-contract.md#at-the-desk-on-a-tablet) instead of emailed: the adopter reads it, signs and pays by card on the tablet themself, with no card reader.

**1. Add the tablet**

Under **A new tablet**, name it (**Front desk**, say) and press **Add a tablet**.

**2. Type the code on the tablet**

On the tablet, open the address shown, your public site followed by `/desk/tablet`, and type the code. The code works once, for 15 minutes, and is not shown again.

**3. Leave it on that page**

The tablet says it is the **Front desk** tablet and is **Ready for the next adopter**. Leave it on that page.

The list says whether each tablet is paired and when it was last seen. A tablet is signed in as nobody: it can only open the contracts handed to it, and only on the same page an adopter's email would open. **Pair again** gives a new code and signs out the tablet that had it, for a tablet lost or replaced. **Remove** signs it out for good, and cancels a contract still waiting for it. Changing them needs **Change** on Animals.

## Application stages

**Settings → Operations & forms → Application stages** is the list of steps an application moves through before it is approved or denied, in your own words. It covers all three kinds: adoption, foster and volunteer. Approved, denied and withdrawn are not stages: they are decisions, recorded on the application itself. See [Applications](https://docs.rescueconsole.com/animals/applications.md).

Each stage shows its name, a lock if it is built in, and how many applications are at it now (**Nobody here**, or a count).

The built-in stages are **Draft**, **Submitted**, **Assigned**, **Under review**, **Pending third party**, **Review complete**, **Meet scheduled** and **Hold for a better match**. A stage sits inside the review: choosing one on an application marks the application under review, or meet scheduled for that stage.

With **Configure** on Animals, each stage has:

| Control | What it does |
| - | - |
| **Every kind**, **Adoption only**, **Foster only**, **Volunteer only** | Which applications the stage is offered on. A stage set to one kind is not offered on the others, which is how a volunteer pipeline stays separate from an adoption one. |
| **Offered** | Untick it to switch a stage off. **Draft**, **Submitted** and **Under review** cannot be switched off, because every application starts or lands on one of them. |
| The arrows | Move the stage up or down. |
| **Rename** | Change its name. |
| The bin | Delete a stage you added. Built-in stages cannot be deleted; switch them off instead. A stage with applications at it cannot be deleted until they are moved. |

To add a stage:

**1. Name it**

Type **A new stage**.

**2. Choose who it is for**

Choose who it is **For**.

**3. Add it**

Press **Add stage**.

No two stages may have the same name.

Anyone else sees each stage with who it applies to, and whether it is switched off.

## Decision reasons

**Settings → Operations & forms → Decision reasons** is why an application is approved, and why one is denied, in your own words: two lists, **Reasons to approve** and **Reasons to deny**. A denial needs a reason; an approval may give one. The applicant is not shown the reason: it stays with your team, on the application and in the reports. See [Approving or denying](https://docs.rescueconsole.com/animals/application-decision.md#approving-or-denying).

The built-in reasons to approve are **A good match**, **Experienced with this kind of animal**, **Home check passed** and **References checked**. The built-in reasons to deny are the seven there have always been: **Housing unsuitable**, **Landlord denied**, **Insufficient experience**, **Incomplete information**, **Animal no longer available**, **A better match was found** and **Other**.

Each reason is one row: its name (a lock marks a built-in one), how many decisions name it (**Not used yet**, or a count), and a line saying who it is for and what choosing it does, such as **Every kind · Does not email them**. With **Configure** on Animals, the arrows move it and **Edit** opens it in a side panel: its **Name**, who it is **For** (**Every kind**, **Adoption only**, **Foster only**, **Volunteer only**), **Offered when deciding**, and **When it is chosen** (below). **Save** keeps what you changed, and **Delete** removes a reason you added that no decision names. A built-in reason can be renamed or switched off, not deleted.

To add one:

**1. Type it**

Type it under **Add a reason to approve** or **Add a reason to deny**.

**2. Choose who it is for**

Choose who it is **For**.

**3. Add it**

Press **Add**.

A decision keeps the words it was made with: renaming **A good match** changes nothing already decided.

### What a reason fills in

In a reason's panel, **When it is chosen** sets what choosing it does to the decision form. Each starts as usual, and the person deciding can still change it.

| Setting | Choices |
| - | - |
| **Email the applicant** | **Email them as usual** (ticked when the applicant has an address), **Email them**, or **Do not email them**. |
| **The message** | Your usual words (your **Application approved** or **Application declined** template, or the built-in words when you keep none), or one of your active templates, filled from the application as the compose window fills it. Shown to someone who can see Communications. |
| **Invite to My portal** | For a reason to approve: **Invite them as usual** (ticked when the applicant has an address), **Invite them to My portal**, or **Do not invite them**. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.