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

# Configure a Custom Domain for Your White-Label Dashboard

> Point your own domain (e.g. app.youragency.com) to your WaMatrix Reseller dashboard so clients always log in under your brand, never WaMatrix.

By default your reseller dashboard lives on a wamatrix.io subdomain. Connecting your own domain means clients log in at a URL you own — like `app.youragency.com` — and never see the WaMatrix name.

## Prerequisites

<Note>
  Before you begin, make sure you have:

  * An active WaMatrix Reseller account
  * A domain you own with DNS access (via your registrar, Cloudflare, Route 53, or similar)
</Note>

## Step-by-Step DNS Setup

<Steps>
  <Step title="Open the Custom Domain settings">
    In your Reseller Dashboard, go to **Settings → White Label → Custom Domain**.
  </Step>

  <Step title="Generate your DNS record">
    Enter your desired subdomain (e.g. `app.youragency.com`) and click **Generate DNS Record**. The dashboard displays the CNAME record you need to add at your DNS provider.
  </Step>

  <Step title="Add the CNAME record at your DNS provider">
    Log in to your DNS provider and create a new CNAME record using the following values:

    * **Name** — `app` (or whichever subdomain prefix you chose)
    * **Value** — the target shown in your dashboard
    * **TTL** — `3600` (or **Auto** if your provider offers it)
  </Step>

  <Step title="Verify DNS propagation">
    Back in the dashboard, click **Verify DNS**. WaMatrix checks whether the record has propagated — this can take anywhere from a few minutes up to **1–4 hours** depending on your DNS provider and TTL.
  </Step>

  <Step title="SSL certificate provisioned automatically">
    Once verification passes, WaMatrix automatically provisions an SSL certificate for your domain. Your dashboard is live at your custom domain within minutes of a successful verification.
  </Step>
</Steps>

## DNS Record Examples

<Tabs>
  <Tab title="Cloudflare">
    | Field        | Value                                        |
    | ------------ | -------------------------------------------- |
    | Type         | CNAME                                        |
    | Name         | `app`                                        |
    | Target       | `reseller.wamatrix.io`                       |
    | Proxy status | **DNS only** (grey cloud — do **not** proxy) |
  </Tab>

  <Tab title="Route 53">
    | Field       | Value                  |
    | ----------- | ---------------------- |
    | Record type | CNAME                  |
    | Name        | `app.youragency.com`   |
    | Value       | `reseller.wamatrix.io` |
    | TTL         | `300`                  |
  </Tab>

  <Tab title="Namecheap">
    | Field | Value                  |
    | ----- | ---------------------- |
    | Type  | CNAME Record           |
    | Host  | `app`                  |
    | Value | `reseller.wamatrix.io` |
    | TTL   | Automatic              |
  </Tab>
</Tabs>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Verification fails after 4 hours">
    * **Cloudflare users:** Make sure the record's proxy status is set to **DNS only** (grey cloud). An orange/proxied cloud intercepts the CNAME and causes verification to fail.
    * Check that your TTL is not set to `0` — some providers interpret this as an invalid or no-cache value.
    * Use a tool like [dnschecker.org](https://dnschecker.org) to confirm the CNAME is resolving correctly from multiple global locations.
  </Accordion>

  <Accordion title="SSL certificate not issued">
    SSL provisioning begins automatically after DNS verification passes. If your certificate has not been issued within **30 minutes** of a successful verification:

    1. Confirm the DNS verification step shows a green checkmark in your dashboard.
    2. Contact WaMatrix support with your custom domain — the team can trigger re-provisioning manually.
  </Accordion>

  <Accordion title="Clients see a security warning">
    The SSL certificate may still be in the process of provisioning. Wait **10 minutes**, then ask the client to do a hard refresh (`Ctrl+Shift+R` / `Cmd+Shift+R`) or try in an incognito window. If the warning persists after 30 minutes, see the SSL troubleshooting step above.
  </Accordion>
</AccordionGroup>

<Tip>
  Use a dedicated subdomain such as `app.` or `crm.` for your dashboard (e.g. `app.youragency.com`). Avoid pointing the root/apex domain (e.g. `youragency.com`) because CNAME records at the apex are not universally supported by DNS standards — some providers will reject the record entirely.
</Tip>