Connect a Namecheap domain

Setup type: Guided manual. Namecheap has no safe delegated write path, so you add the records in the Namecheap DNS panel yourself. The app shows the exact values and verifies them for you.

Namecheap connects via the guided-manual path by default: CustomDomain shows the exact records and you add them in Namecheap's Advanced DNS panel, then it verifies. Namecheap does have an API, but its shape makes copy-paste the safer default.

What you'll need

• A domain whose DNS is managed at Namecheap.
• Access to your app's CustomDomain dashboard (it shows the exact target for your account).

The records

CustomDomain gives you the authoritative records for your account in the dashboard, typically a CNAME (or apex A/ALIAS) pointing your domain at the edge. Use the values shown there; the shape is always the same, the target is per-account. There is no separate ownership TXT to add on this path: control is proven by the rail itself, or by the records appearing in your own authoritative DNS. See Setup types.

Setting it up on Namecheap

1. Open your Namecheap DNS panel (here).
2. Add the exact records the dashboard shows, usually one CNAME (or A records if you are connecting the apex).
3. Come back; CustomDomain polls DNS and marks the domain live once records resolve.

Namecheap specifics

• Namecheap's DNS API is a full-zone setHosts replace, it overwrites the whole record set rather than adding one record, and it is IP-allowlisted, so the guided-manual path is the default to avoid clobbering existing records.
• Add the records under Domain List > Manage > Advanced DNS.
• API is full-zone setHosts (dangerous replace) and IP-allowlisted, manual by default, adapter available for tenants who accept the risk.

How you know it worked

CustomDomain polls public DNS and issues the TLS certificate automatically. When the dashboard shows the domain live, HTTPS is serving. Drift monitoring then watches the records so a later change at the provider doesn't silently break the domain.

FAQ

Why isn't Namecheap one-click?

Namecheap's API replaces the entire DNS zone in one call and requires IP allowlisting, so a safe automatic write isn't practical for arbitrary users. The guided path shows you the exact records to add, which is quick and can't overwrite your other records.

Related

• All DNS providers, the full connection catalog.
• How custom domains work