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

# Connect your agency domain

> Serve your agency's DMLY on a domain you own, so your customers sign up and work under your address instead of a DMLY one.

The agency dashboard is only available once you have an agency, which comes from subscribing to a reseller plan — see [Agency overview](/agency/overview) and [Plans](/billing/plans).

Your custom domain is what makes the whitelabel real. Your [branding](/agency/branding) — your app name, your colour, your logo — is applied by the address the page was opened on. Your public sign-up page only exists on your own domain: on the DMLY address it isn't there at all. So until a domain is connected, there's no address you can hand to a prospect.

You get one custom domain per agency.

<Note>
  This is not the [booking domain](/appointments/custom-domain). A booking domain belongs to a single workspace and serves that workspace's public booking page. An agency domain belongs to you, the agency, and serves the whole product — sign-up, login and the dashboard your customers work in. A host can only be one or the other; if you try to connect a domain that's already in use as a booking domain, you'll see **That domain is already in use.**
</Note>

## Connect it

Open **Reseller Dashboard** from your user menu, then go to **Configuration → Domain**.

<Steps>
  <Step title="Point your DNS">
    The panel shows the records to create under **Create one of these records at your DNS provider:** — a **CNAME** or an **A record**. Add one of them at whoever manages your domain's DNS, your registrar or your web host. DMLY doesn't do this part for you.
  </Step>

  <Step title="Add your domain">
    Enter the host you want to use — for example `app.yourbrand.com` — and select **Add domain**.
  </Step>

  <Step title="Verify">
    Select **Verify**. If the record hasn't spread yet you'll get **DNS is not pointing here yet. Check the record and try again.** — that's normal shortly after a DNS change. Leave it and try again later; DMLY also re-checks on its own roughly every ten minutes and verifies the domain as soon as it resolves.
  </Step>
</Steps>

Once it verifies, SSL is requested and issued for you automatically. You don't buy or install a certificate.

## What the status means

The panel shows one of three states:

* **Pending DNS** — the domain is saved but nothing points at it yet.
* **Verified · issuing SSL** — DNS resolves, and the certificate is being issued. This isn't instant.
* **SSL active** — DMLY has loaded your domain over HTTPS and confirmed the certificate is really live. The badge only turns green on a real end-to-end check, so it can't tell you the domain is ready when it isn't.

Wait for **SSL active** before you publish the address anywhere.

<Note>
  The background check runs in both directions, so a live domain isn't permanently live. If the DNS record is removed or stops resolving for around a day, the domain drops back to **Pending DNS** on its own. Keep the record in place for as long as you want the domain.
</Note>

## Remove a domain

Select **Remove** on the domain row, then confirm with **Remove domain**. To move to a different host, remove the current one first — while a domain is connected the add field is replaced by **You’ve connected a custom domain. Remove it below to connect a different one.**

<Warning>
  Removing the domain takes away the only address your public sign-up page lives on, and your existing customers lose the address they log in at. Have the replacement domain verified and live before you switch, and tell your customers.
</Warning>

## If it won't verify

<Accordion title="The domain never verifies">
  DMLY can only verify a host that actually points at it, so the cause is almost always the DNS record. Re-check it against what the panel shows: the record type, the exact host, and that there isn't an older conflicting record for the same name still in place. Some DNS providers append your domain to the host automatically, which silently produces `app.youragency.com.youragency.com`. After a correction, select **Verify** again.
</Accordion>

<Accordion title="That domain is already in use">
  The host is claimed elsewhere — most often as a workspace [booking domain](/appointments/custom-domain), including in one of your own sub-accounts. Pick a different host, or free the existing one first. You also can't use the DMLY address itself.
</Accordion>

<Columns cols={2}>
  <Card title="Branding" icon="palette" href="/agency/branding">
    Your app name, colour, logo and support email — applied on your domain.
  </Card>

  <Card title="Client workspaces" icon="users" href="/agency/client-workspaces">
    The sub-accounts that arrive when customers sign up on your domain.
  </Card>
</Columns>