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

# Properties

> Every homeowner and pool you've worked on: records, equipment, warranties, and recalls.

The **Properties** — your homeowner and pool records — is where every person who has ever contacted your company and every pool you've ever touched lives. Homeowners appear here automatically the moment they chat, text, submit a form, or book an appointment. Properties are created when a bid references them or when you add one manually. No CRM setup, no imports — the Properties fills itself in as you work.

## The homeowner list

Open **Properties** from the sidebar to see every homeowner. The list shows each person's name, their properties, total estimated value, appointment count, and last activity. Tags highlight what matters: **Returning**, **High-value**, **Opted out**, and dots for homeowners who owe a review or have a recall due.

### Find a homeowner

<Steps>
  <Step title="Search or filter">
    Type a name, phone number, or email in the search bar. Or use the segment tabs at the top — **All**, **Returning**, **High-value**, and more — to filter the list.
  </Step>

  <Step title="Open the record">
    Click any homeowner to open their detail panel.
  </Step>
</Steps>

### What's in a homeowner record

The detail panel shows everything Kordless knows about this person, in one glance:

* **Identity** — name, phone, email. Click **Edit** to correct a name or merge a duplicate.
* **Agent notes** — notes you write that the agent uses as context when talking to this homeowner. Add details like "prefers text over email" or "asked about a spa combo on the remodel."
* **Properties** — this homeowner's pools, each with its own bid and job history. Click **Full record** on any property to open its dedicated page.
* **Timeline** — a merged chronological feed of every interaction: bids, appointments, conversations, and form submissions.

### Add a property to a homeowner

When a returning homeowner has a new pool or a second property, add it to their Properties:

<Steps>
  <Step title="Open the homeowner">
    Find and click the homeowner in the list.
  </Step>

  <Step title="Click Add property">
    The button appears under the Properties section.
  </Step>

  <Step title="Enter the property details">
    Fill in the property label (e.g., "Main residence"), pool type, size class, and gallons at minimum. You can also add surface material, access type, and equipment.
  </Step>

  <Step title="Save">
    Click **Add**.
  </Step>
</Steps>

You're taken straight to the new property's full record page, where you can add equipment, warranties, and season dates.

### Homeowner actions

From the detail panel you can also:

* **Book again** — create a new appointment for this homeowner, pre-filled with their info
* **Request review** — send a review request through the agent
* **Message** — open the inbox thread with this homeowner
* **Merge** — combine a probable duplicate into one record
* **Forget** — permanently delete a homeowner and their data (irreversible)

<Warning>
  **Forget homeowner** is irreversible. It removes the homeowner, their properties, bids, and conversation history. Use it only for data-privacy requests or test data cleanup.
</Warning>

### Export homeowners

Click **Export** to download your homeowner list as a CSV. You can export all homeowners or filter by segment first — useful for a mailing list or a reactivation campaign.

## The property record

Each property has its own page at **Properties → property → Full record**. This is the operational heart of Properties: the complete lifecycle of one pool, from the first bid to the latest recall.

### What's on the property page

* **Identity** — property label, pool type, size class, gallons, surface material, access type. Click any field to edit.
* **Owner** — the homeowner who owns this property, with their contact info.
* **Season dates** — the pool's seasonal opening and closing dates, which drive seasonal recalls. Set these once and the agent uses them year after year.
* **Lifecycle** — a computed status that summarizes where this property is in its relationship with your company: active project, under contract, recall due, lapsed, and so on.
* **Jobs** — every bid that references this property, in reverse chronological order. Each shows the state (quoted, deposited, completed, expired, declined), the bid price range, the final invoice amount, completion date, and booking status. Check-in photos and completion photos are attached when available.
* **Equipment** — every piece of equipment installed on this pool: type (pump, filter, heater, salt cell, cleaner), brand, model, install date, and warranty term.
* **Warranties** — registered warranties with provider, plan, registration ID, term, start and expiry dates, status, and linked document.
* **Contracts** — any active, paused, or canceled maintenance contract on this property, with the service label and status.
* **Recalls** — any due, approved, or snoozed recall for this property, with the service label and relative due date.
* **Timeline** — a merged chronological feed of every event on this property: bids, equipment installs, warranty registrations, contract changes, and recalls.

### Record equipment

After installing or replacing equipment, record it so you have a traceable record for warranty claims and service calls:

<Steps>
  <Step title="Open the property record">
    From Properties, find the homeowner, then click **Full record** on the property.
  </Step>

  <Step title="Add an equipment entry">
    In the Equipment section, click **Add equipment**.
  </Step>

  <Step title="Enter the details">
    Select the type (pump, filter, heater, salt cell, cleaner, or other). Enter the brand, model, and install date. Set the warranty term in months if applicable.
  </Step>

  <Step title="Save">
    Click **Save**.
  </Step>
</Steps>

The equipment appears in the Equipment section and on the timeline. You can edit or remove an entry at any time — click the equipment entry to edit, or the trash icon to remove it.

### Register a warranty

When you register a warranty with an equipment manufacturer, record it on the property:

<Steps>
  <Step title="Open the property record">
    Navigate to the property's full record page.
  </Step>

  <Step title="Add a warranty">
    In the Warranties section, click **Add warranty**.
  </Step>

  <Step title="Enter the details">
    Fill in the provider, plan name, registration ID, term in months, and start date. The expiry date is calculated from the term. If you have a registration document URL, add it.
  </Step>

  <Step title="Set the status and save">
    New warranties start as **Registered**. Once the manufacturer confirms, set it to **Active**. Click **Save**.
  </Step>
</Steps>

The warranty appears in the Warranties section with its status badge. You can update the status at any time — Registered, Active, Expired, or Void. The expiry date shows a relative label like *expires in 10 months* so you can see at a glance what's still covered.

<Accordion title="What if a warranty is void?">
  Set the warranty status to **Void**. A void warranty stays on the property's record for traceability but no longer shows an expiry label. If the warranty was registered in error, you can remove it entirely with the trash icon.
</Accordion>

### Set season dates

Season dates tell Kordless when this pool typically opens and closes for the season. The agent uses these dates to draft seasonal recall reminders — opening and closing service outreach — automatically. Set them once per property:

<Steps>
  <Step title="Open the property record">
    Navigate to the property's full record page.
  </Step>

  <Step title="Find the Season dates section">
    Enter the opening month and day (for example, April 15) and the closing month and day (for example, October 31).
  </Step>

  <Step title="Save">
    Click **Save**. The agent uses these dates to schedule seasonal recalls going forward.
  </Step>
</Steps>

For indoor pools or year-round service markets, leave the dates blank — the agent will only schedule interval recalls, not seasonal ones.

### Save completion photos

After completing a project, attach completion (after) photos to the bid so the condition record is complete:

<Steps>
  <Step title="Open the property record">
    Find the property and open its full record page.
  </Step>

  <Step title="Find the completed job">
    In the Jobs section, locate the completed bid.
  </Step>

  <Step title="Upload completion photos">
    Upload or paste the photo URLs. Up to 24 photos can be attached per job.
  </Step>
</Steps>

Completion photos appear alongside the check-in (before) photos, giving you a complete before-and-after record for warranty disputes or marketing.

## How Properties connects to the rest of Kordless

* **Bids** — every bid in the [Bid Desk](/pool-spa/bidding/overview) references a property in Properties. When a new homeowner's first bid goes out, the property is created automatically.
* **Service calendar** — when a homeowner pays a deposit and books a slot, the appointment lands on your [Service calendar](/pool-spa/day/service-calendar) and the property gets its record here.
* **Contracts** — maintenance [contracts](/pool-spa/day/contracts) are linked to a property. The contract's state (active, paused, canceled) appears on the property record.
* **Recalls** — when a service has a recall interval (e.g., equipment service every 365 days) or a seasonal anchor (pool opening in April), the [recall engine](/pool-spa/day/recalls) scans completed jobs and season dates, then surfaces due properties on the [Today](/pool-spa/day/today) page and on the property record itself.
* **Today** — the right rail's **Reviews owed** and **Recalls due** counters pull from Properties. Approve them in bulk from Today, or handle them one at a time here.

## Next steps

<CardGroup cols={2}>
  <Card title="Today" icon="sun" href="/pool-spa/day/today">
    Your morning feed: overnight activity and decisions waiting on you.
  </Card>

  <Card title="Maintenance contracts" icon="repeat-2" href="/pool-spa/day/contracts">
    How recurring service agreements work: activation, pause, and renewal.
  </Card>
</CardGroup>
