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

# Domain Setup

> Connect Domain profile, sync listing data, and troubleshoot profile/credential issues.

## Prerequisites

* Workspace admin integration permission
* Domain profile details (agent or agency)
* Provider credentials and account readiness

## Setup steps

1. Open **Integrations**.
2. Select **Connect** for Domain.
3. Choose profile type and select the correct profile.
4. Confirm and run initial sync.

## Sync expectations

* Listings and metadata sync into knowledge sources.
* Connected status and last sync timestamp should be visible.

## Leased listings

Domain surfaces rental listings that have been **leased**. Tick **Leased listings** in your Domain integration settings to keep leased rentals in your Knowledge Base with the lease start date, weekly rent, and a derived lease term and end date.

* **Opt-in**: leased listings are off by default. Enable the toggle and run a sync to pull them.
* **What you get**: a **Leased** badge, weekly rent, lease start date, plus a derived lease term and end date.
* **Derived end-date caveat**: Domain provides a lease duration rather than an explicit end date, so Voqo derives the end date from the start date plus the duration. This is accurate for fresh leases but can drift after a renewal or early termination — check Domain directly for ground-truth dates in those cases.
* **Leased vs withdrawn**: the **Leased listings** toggle captures rentals that were genuinely leased to a tenant. Rentals that were **withdrawn or expired** (taken off the market without a lease) are treated as off-market — they come in under the **Sold & off-market listings** toggle instead, not this one.

See [Leased Listings](../knowledge-base/leased-listings) for the full picture across all your integrations.

## Choose how far back to keep sold and leased listings

When you enable **Sold & off-market listings** or **Leased listings**, a **Historical listing window** selector appears in your Domain settings. It controls how far back Voqo includes sold, leased, and off-market listings on the next sync, based on when each listing was last updated.

* **Pick a window** — **Last 1 month**, **Last 3 months**, **Last 6 months**, **Last 12 months** (the default), or **Last 24 months**.
* **Older listings roll off automatically.** A sold or leased listing that hasn't been updated within your chosen window drops out of your Knowledge Base on the next sync, keeping your sold and leased history focused on recent activity.
* **Widen the window to bring older listings back.** Switch to a longer window and run a sync — the older sold and leased listings reappear.
* **The selector only shows when Sold or Leased is enabled.** Your live and forthcoming stock is never affected by this window — current listings always sync in full.

## Turning a scope off — and getting your listings back

When you turn **off** a listing scope (such as **Sold & off-market listings** or **Leased listings**) in your Domain settings, Voqo **removes** the already-synced listings of that type from your Knowledge Base. This keeps your Knowledge Base aligned with the scopes you've chosen.

Because this removes records, Voqo always asks you to confirm first:

* **You'll see a confirmation dialog** telling you exactly **how many listings** will be removed, and **which manually managed lists** they sit in (if any), before anything is deleted.
* **Nothing is removed until you confirm.** Click **Cancel** to leave everything in place.
* **Nothing is lost permanently.** You can **restore** these listings at any time by re-enabling the scope and running a sync — they'll flow back into your Knowledge Base.

<Note>
  Turning a scope off only removes listings of **that type**. Your live listings and any other enabled scopes are untouched.
</Note>

## Retry and recovery

* Profile mismatch: reselect the correct profile and reconnect.
* Credential/provider failure: verify account state, then retry sync.
* Stale data: run manual resync and validate source updates upstream.
* **My sold or leased listings disappeared.** You may have turned off the matching scope, or an older listing rolled off your **Historical listing window**. Re-enable the scope (or widen the window) and run a sync to bring them back.
* **Sold or leased listings haven't appeared after enabling the scope.** Click **Sync now** on the Domain card. The next scheduled sync also picks them up automatically.

## Related docs

* [Choose and Connect Integrations](overview-integration)
* [Knowledge Base Lists and Sources](knowledge-base-integrations)
* [Leased Listings](../knowledge-base/leased-listings)