CustomDomain docs
Providers

Connect a Vercel domain

Put a custom domain from Vercel on your app with automatic HTTPS. One-click (OAuth) setup, the exact DNS records, and how to verify it went live.

Connect a Vercel domain

Setup type: One-click (OAuth). You sign in to Vercel in a popup and approve the change. No records to copy; no password is shared with the app.

Vercel supports native "Sign in with Vercel" OAuth, which is the preferred rail: approve in a Vercel window and the records are written for you. Vercel is also on the Domain Connect list and accepts a BYO token, so there are three working paths, OAuth is the smoothest.

What you'll need

  • A domain whose DNS is managed at Vercel.
  • 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 Vercel

  1. In the connect widget, choose Vercel and click connect.
  2. A Vercel sign-in window opens. Approve the requested DNS change.
  3. The records apply automatically; you're returned to the app, which verifies and goes live.

Vercel specifics

  • The same Vercel bearer that authorizes the connection drives Vercel's DNS API.
  • If you deploy the app itself on Vercel, connecting a customer's domain is still a DNS operation at wherever that customer's domain resolves, not a Vercel project setting.
  • Native 'Sign in with Vercel' OAuth preferred; also on the canonical DC list and BYO-token API-capable.

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

I host on Vercel, is this different from adding a domain to my Vercel project?

Yes. This connects an end-user's own domain to your app with automatic HTTPS at the edge, across the 63 catalogued DNS and registrar providers. Adding a domain to your Vercel project only covers domains you control.

On this page