Custom domains
Serve your gateway from your own hostname so end users never see a Spanly URL.
Custom domains are available on the Business plan. They let your users
connect to mcp.your-company.com instead of a Spanly subdomain. TLS
certificates are issued and renewed for you.
Add a domain
On the Gateway tab, in the Custom domain section, enter your domain and select Add domain. Spanly shows two DNS records you must create at your DNS provider:
| Type | Name | Value |
|---|---|---|
| TXT | _spanly-verify.mcp.your-company.com | the verification token shown |
| CNAME | mcp.your-company.com | your-project.gateway.us.spanly.com |
The TXT record proves you own the domain. The CNAME routes traffic to your gateway. For an apex domain that cannot carry a CNAME, use an ALIAS or ANAME record pointing at the same target.
Verification and TLS
Once both records resolve, the status moves from Waiting for DNS to Issuing certificate to Active. DNS propagation can take anywhere from a few minutes to a few hours depending on your provider. The dashboard polls and updates the status automatically. If verification fails, the reason is shown and you can retry after fixing the records.
Remove a domain
Removing a domain stops it resolving immediately, so any client using that
hostname loses connectivity. Your gateway's default .gateway.<region>.spanly.com
endpoint keeps working.