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

# Custom Domains & White-Labeling

> Set up a branded landing page on your own domain

White-labeling lets you serve a fully branded landing page on your own domain. Visitors see your brand name, colors, legal copy, and signup form — with no mention of Trackly SMS.

Each white-label domain automatically serves:

* A branded **landing page** with signup form
* A **privacy policy** page
* A **terms & conditions** page
* An **SMS terms** page

## DNS Setup

Follow these steps to point your domain at the white-label service.

### 1. Choose Your Domain

Pick a subdomain or apex domain, for example:

* `alerts.yourbrand.com`
* `sms.yourbrand.com`
* `yourbrand.com`

### 2. Add a CNAME Record

In your DNS provider, create a CNAME record pointing to the Trackly proxy server:

| Type  | Name     | Value                  |
| ----- | -------- | ---------------------- |
| CNAME | `alerts` | `proxy.tracklysms.com` |

<Note>
  If you need to use an apex domain (e.g. `yourbrand.com` without a subdomain), some DNS providers support CNAME flattening or ALIAS records. Create a support ticket from your dashboard (**Support > New Ticket**) for help with apex domains.
</Note>

### 3. Submit a Setup Request

Create a support ticket from your dashboard (**Support > New Ticket**) with the following details:

* Your domain name
* Your brand name
* Your vertical/industry
* Brand colors and logo

We'll register your domain in the white-label system and configure your brand template.

### 4. SSL Certificate

Once your CNAME is in place and the domain is registered, the Caddy proxy server automatically provisions an SSL certificate via Let's Encrypt. No manual certificate setup is needed.

### 5. Verify

Visit your domain in a browser. You should see your branded landing page with a valid HTTPS certificate.

## How It Works

The architecture behind white-label domains:

```
Visitor's browser
    → CNAME resolves to Caddy proxy server
    → Caddy auto-provisions SSL via Let's Encrypt
    → Caddy forwards request to Cloud Run (white-label service)
    → Service reads the hostname from X-Original-Host header
    → Looks up brand config for that hostname
    → Renders the appropriate template with brand replacements
    → Returns fully branded HTML page
```

Each domain is mapped to a **brand config** — a set of placeholder values that get substituted into the HTML template. This means the same template can serve many different brands, each with unique copy, colors, and legal text.

## Template Customization

Every white-label domain gets a brand config with replaceable fields. The generic template supports customization of:

* **Brand identity** — Name, logo, favicon
* **Colors** — Primary accent color for buttons, links, and highlights
* **Hero section** — Headline and description text
* **How It Works** — Step-by-step explanation of your service
* **FAQ** — Questions and answers relevant to your vertical
* **Footer disclaimers** — Legal text appropriate for your industry
* **Contact info** — Email, phone, physical address
* **Legal** — Governing state, company legal name

For the full list of configurable fields, see the [White-Label Reference](/account/white-label-reference).

## Available Verticals

The white-label system supports any vertical. Here are common configurations:

| Vertical                  | Example Content                                    | Disclaimer Focus                                |
| ------------------------- | -------------------------------------------------- | ----------------------------------------------- |
| Financial / Investing     | Market insights, stock research, trading alerts    | Investment disclaimers, not personalized advice |
| Nutra / Health & Wellness | Supplement reviews, nutrition tips, wellness deals | FDA disclaimers, not medical advice             |
| Ecommerce / Deals         | Product deals, flash sales, discount codes         | Standard commercial terms                       |
| General / Custom          | Any content type                                   | Custom disclaimers for your industry            |

## Requesting a Custom Template

To set up white-labeling, create a support ticket from your dashboard (**Support > New Ticket**) with:

1. **Brand name** — What visitors will see
2. **Domain** — The domain you'll point at the service
3. **Vertical** — Financial, nutra, ecommerce, or other
4. **Brand colors** — Primary accent color (hex code)
5. **Logo** — Image file for the header (optional)
6. **Legal entity** — Company legal name for terms/privacy pages
7. **Contact info** — Email, phone, mailing address
8. **Governing state** — For legal page jurisdiction
9. **Custom content** — Hero copy, FAQ, how-it-works steps, disclaimers (optional — we provide sensible defaults)

## Legal Pages

Each white-label domain automatically serves three legal pages with your brand replacements applied:

| Page               | Route             | Contents                                                      |
| ------------------ | ----------------- | ------------------------------------------------------------- |
| Privacy Policy     | `/privacy-policy` | Data collection, usage, sharing practices                     |
| Terms & Conditions | `/terms`          | Service terms, liability limitations                          |
| SMS Terms          | `/sms-terms`      | SMS-specific consent, opt-out instructions, message frequency |

All pages display your brand name, company legal name, contact info, and governing state.

## Next Steps

<CardGroup cols={2}>
  <Card title="White-Label Reference" icon="palette" href="/account/white-label-reference">
    Full list of placeholder fields and example configs
  </Card>

  <Card title="Billing" icon="credit-card" href="/account/billing">
    Understand usage and costs
  </Card>
</CardGroup>