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

# Custom Domain

> Serve the white-label app from your own domain

You can serve the white-label app from a Cadana-provided subdomain or your own custom domain.

***

## Option 1: Cadana-Provided Subdomain

By default, Cadana provides all white-label clients with a unique subdomain (e.g. `yourcompany.cadanapay.com`). No configuration needed — you can use it directly or redirect from your own domain.

***

## Option 2: Custom Domain

For a fully branded experience, provide your own domain (e.g. `payroll.yourcompany.com`). Cadana will generate ACM (AWS Certificate Manager) certificates that you verify via DNS.

### Setup steps

<Steps>
  <Step title="Provide your domain">
    Share your custom domain with your account manager.
  </Step>

  <Step title="Receive DNS records">
    Cadana generates ACM certificates and sends you CNAME records to add.
  </Step>

  <Step title="Add DNS records">
    Add the CNAME records to your domain's DNS configuration.
  </Step>

  <Step title="Verification">
    Cadana verifies the certificates and completes the setup.
  </Step>
</Steps>

### Example DNS records

| Domain            | Record Name                   | Type  | Value                                  |
| :---------------- | :---------------------------- | :---- | :------------------------------------- |
| `app.example.com` | `_53dc40d...app.example.com.` | CNAME | `_ec562bv...acm-validations.aws.`      |
| `app.example.com` | `app.example.com`             | CNAME | `{{uniquePlatformID}}.cloudfront.net.` |

<Note>
  DNS propagation can take up to 48 hours. Do not direct traffic to the custom domain until Cadana confirms the certificates are verified.
</Note>