> For the complete documentation index, see [llms.txt](https://docs.whiteswan.io/partner-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whiteswan.io/partner-knowledge-base/branding-and-white-labeling/infrastructure-and-communications/custom-domain.md).

# Custom Domain

#### **Overview**

White Swan allows you to fully white-label your client experience using your own domain.

Instead of sending clients to a generic link, you can host your entire experience on a domain you control — creating a seamless, branded journey from start to finish.

For most partners, this is the **recommended way to get started with infrastructure white labeling**, as it:

* Requires minimal setup
* Immediately strengthens trust with clients
* Creates a consistent branded experience

***

#### **How it works**

You connect a domain or subdomain (e.g. `insurance.yourcompany.com`) to White Swan. Once connected:

* All client-facing pages run on your domain
* Links shared with clients are branded
* The experience feels fully owned by your company

We recommend using a **subdomain** rather than your main website domain to avoid conflicts.

***

#### **Setup Flow**

To access 

**Step 1: Enter Your Domain**

Provide the domain or subdomain you want to use.

Examples:

* `insurance.yourcompany.com`
* `apply.yourcompany.com`

Avoid:

* Using your root domain if it already hosts a website

***

**Step 2: Configure DNS**

We’ll generate DNS records for you.

You’ll need to:

1. Go to your DNS provider (e.g. GoDaddy, Cloudflare)
2. Add the records exactly as provided
3. Save changes

Once added, click **Verify** inside White Swan.

***

**Step 3: Verify & Activate**

Domain verification can take:

* A few minutes (fast cases)
* Up to 48 hours (depending on DNS propagation)

Once verified:

* Your domain becomes active
* Your experience is live on your branded URL

***

#### **Customize Your Domain Experience**

After setup, you can customize:

* Search/social sharing title
* Description (SEO preview)
* Sharing image
* Favicon

This ensures your links look polished when shared.

***

#### **Managing Your Domain**

You can:

* Update branding and metadata anytime
* Edit or replace your domain
* Remove and restart setup if needed


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.whiteswan.io/partner-knowledge-base/branding-and-white-labeling/infrastructure-and-communications/custom-domain.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.