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

# Contract Fields and Variables

> Every dog field you can print on a contract and every ${...} variable you can type into contract text: dog name, call name, sire and dam names and call names, registration numbers, microchip, price, deposit and balance, buyer name and address, kennel details, buyer initials and custom variables.

# Contract Fields and Variables

A contract can pull dog, buyer and kennel details from your records in two ways:

* **Dog Fields to Include**: boxes you tick when editing a contract. Each ticked field prints in the dog's details box at the top of the contract.
* **Variables**: placeholders like `${dog.call_name}` that you type into the contract's **Terms & Conditions**. Each one is replaced with the real value when you send or print the contract.

If something isn't listed on this page, contracts can't fill it in automatically yet. Use a custom variable instead (see the end of this page).

***

## Dog Fields to Include

Open your contract in [**Contracts**](https://app.breederbuddy.com/contracts), click **Edit**, tick the boxes under **Dog Fields to Include**, and click **Save**.

| Box | What it prints |
| - | - |
| **Dog Name** | The dog's **Name** from its profile (often the registered name) |
| **Call Name** | The dog's **Call Name**, the name you use day to day |
| **Date of Birth** | The dog's birthday, like "March 1, 2026" |
| **Sex** | Male or Female |
| **Dog Type** | The dog's type, like Puppy or Active Breeding Dog |
| **Microchip** | The microchip number |
| **Registration #1, #2, #3** | The dog's registration numbers. If you renamed them (like "AKC #"), the boxes use your names |
| **Registration PIN** | The registration PIN, only when it's marked visible on the dog |
| **Breed**, **Color**, **Coat**, **Size**, **Height** | Those details from the dog's profile |
| **Market Price** | The dog's **Sale Price** |
| **Deposit Paid** | The puppy's **Deposit Received**, or the deposits this buyer has paid |
| **Balance Due** | The price less everything paid |
| **Fertility Status**, **Market Status**, **Description** | Those details from the dog's profile |
| **Sire Name** | The sire's **Name** (often the registered name) |
| **Sire Call Name** | The sire's **Call Name** |
| **Sire Reg #1, #2, #3** | The sire's registration numbers |
| **Dam Name** | The dam's **Name** (often the registered name) |
| **Dam Call Name** | The dam's **Call Name** |
| **Dam Reg #1, #2, #3** | The dam's registration numbers |

The sire and dam fields come from the sire and dam set on the puppy's profile, and their call names come from each parent's own profile. A box prints N/A when that field is empty.

**Buyers unsure which puppy they're getting?** Tick **Call Name** next to **Dog Name**, and **Sire Call Name** and **Dam Call Name** next to the sire and dam names. The contract then shows the names your buyers know, along with the registered names.

***

## Variables You Can Type

Type any of these into your contract's **Terms & Conditions**, exactly as written, including the `${` and `}`.

### Dog

These fill in from the dog you pick when you send or print the contract.

| Variable | What it fills in |
| - | - |
| `${dog.name}` | The dog's **Name** (often the registered name) |
| `${dog.call_name}` | The dog's **Call Name** |
| `${dog.type}` | The dog's type |
| `${dog.dob}` | Date of birth |
| `${dog.is_male}` | Male or Female |
| `${dog.breed}` | Breed |
| `${dog.color}` | Color |
| `${dog.coat}` | Coat |
| `${dog.size}` | Size |
| `${dog.height_in}` | Height |
| `${dog.fertility_status}` | Fertility status |
| `${dog.microchip}` | Microchip number |
| `${dog.status}` | Market status |
| `${dog.description}` | Description |
| `${dog.sale_price}` | The dog's **Sale Price** |
| `${dog.registration_number_1}` | Registration #1 |
| `${dog.registration_number_2}` | Registration #2 |
| `${dog.registration_number_3}` | Registration #3 |
| `${dog.registration_pin}` | Registration PIN, only when it's marked visible on the dog |
| `${dog.sire_name}` | The sire's **Name** (often the registered name) |
| `${dog.sire_call_name}` | The sire's **Call Name** |
| `${dog.sire_registration_number_1}` | The sire's registration #1 |
| `${dog.sire_registration_number_2}` | The sire's registration #2 |
| `${dog.sire_registration_number_3}` | The sire's registration #3 |
| `${dog.dam_name}` | The dam's **Name** (often the registered name) |
| `${dog.dam_call_name}` | The dam's **Call Name** |
| `${dog.dam_registration_number_1}` | The dam's registration #1 |
| `${dog.dam_registration_number_2}` | The dam's registration #2 |
| `${dog.dam_registration_number_3}` | The dam's registration #3 |
| `${dog.external_sire_name}` | The outside sire's name typed on the puppy's record, for a sire you don't own |
| `${dog.external_dam_name}` | The outside dam's name typed on the puppy's record, for a dam you don't own |

For example: `Your puppy, ${dog.call_name} (${dog.name}), is out of ${dog.sire_call_name} and ${dog.dam_call_name}.`

### Sale

These are worked out from the puppy's price and the buyer's invoices. They need both a buyer and a puppy.

| Variable | What it fills in |
| - | - |
| `${sale.price}` | The puppy's **Sale Price** |
| `${sale.deposit_paid}` | The puppy's **Deposit Received**, or the deposits this buyer has paid toward this puppy |
| `${sale.paid_to_date}` | The deposit plus anything else this buyer has paid toward this puppy |
| `${sale.balance_due}` | The price less everything paid so far |

You can change any of these amounts on the send form before the contract goes out. See [Contracts](https://breederbuddy.com/docs/features/buyer-sales-management/contracts.md) for how deposits are counted.

### Buyer (Contact)

These fill in from the buyer you pick under **Customer**.

| Variable | What it fills in |
| - | - |
| `${contact.first_name}` | First name |
| `${contact.last_name}` | Last name |
| `${contact.full_name}` | First and last name |
| `${contact.email}` | Email |
| `${contact.email_secondary}` | Second email |
| `${contact.phone}` | Phone |
| `${contact.organization}` | The buyer's company or kennel |
| `${contact.street_address}` | Street address |
| `${contact.city}` | City |
| `${contact.state}` | State |
| `${contact.postal_code}` | ZIP or postal code |
| `${contact.country}` | Country |
| `${contact.full_address}` | The whole address on one line |

### Your Kennel

| Variable | What it fills in |
| - | - |
| `${organization.name}` | Your kennel name |
| `${organization.business_address}` | Your business address |
| `${organization.website_url}` | Your website |
| `${organization.preferred_currency}` | Your currency |
| `${organization.owner_first_name}` | The account owner's first name |
| `${organization.owner_last_name}` | The account owner's last name |
| `${organization.owner_full_name}` | The account owner's full name |
| `${organization.owner_email}` | The account owner's email |
| `${organization.owner_phone_number}` | The account owner's phone number |

### Buyer Initials

| Variable | What it does |
| - | - |
| `${buyer.initials}` | A spot the buyer taps to initial while signing online. Each one is its own spot |

You can also click **+ Buyer initials** above the contract text instead of typing it.

***

## Custom Variables

Anything not listed above can be a custom variable. Make up a name that starts with a lowercase letter and uses only letters, numbers and underscores, like `${pickup_date}` or `${puppy_collar_color}`, and type it into your contract. When you send or print the contract, BreederBuddy asks you to type in a value for each one.

A custom variable must not start with `dog.`, `contact.`, `organization.`, `sale.` or `buyer.`. Those names are kept for the variables on this page, and a misspelled one, like `${dog.callname}`, shows an error when you save.


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