What I Do
Manage DNS records for domains hosted on Vercel, including:
- List existing DNS records
- Add new DNS records (A, AAAA, CNAME, TXT, MX, etc.)
- Remove DNS records
- Switch between Vercel teams/accounts
Prerequisites
- Vercel CLI installed:
npm i -g vercelorbrew install vercel-cli - Logged in:
vercel login - Domain must be on Vercel nameservers or have Vercel as DNS provider
0 Finance Project
For the 0 Finance project, always use --scope prologe:
vercel dns ls 0.finance --scope prologe
vercel logs www.0.finance --scope prologe
Common Commands
Check Login & Team
# Check who you're logged in as
vercel whoami
# List available teams
vercel teams ls
# Switch to a specific team (use slug, not display name)
vercel switch <team-slug>
# Or use --scope flag instead of switching
vercel domains ls --scope prologe
List Domains & Records
# List all domains in current team/account
vercel domains ls --scope prologe
# List DNS records for a specific domain
vercel dns ls <domain> --scope prologe
Add DNS Records
# Add A record
vercel dns add <domain> <subdomain> A <ip-address>
# Add CNAME record
vercel dns add <domain> <subdomain> CNAME <target>
# Add TXT record (use quotes for values with special chars)
vercel dns add <domain> <subdomain> TXT '<value>'
# Add MX record with priority
# NOTE: MX priority is a separate argument (not embedded in the value)
vercel dns add <domain> <subdomain> MX <mail-server> <priority>
# Add record at apex (root domain) - use empty string or @
vercel dns add <domain> '' TXT '<value>'
vercel dns add <domain> @ MX mail.example.com 10
Remove DNS Records
# First list to get record ID
vercel dns ls <domain>
# Remove by record ID
vercel dns rm <record-id>
# Remove with confirmation skip
vercel dns rm <record-id> --yes
Examples
Add Email DNS Records (MX + SPF)
# Add MX record for receiving email
# WARNING: Setting MX at the apex (root) will route *all* inbound mail for the domain.
# If the domain already uses Google Workspace / Fastmail / etc, prefer a dedicated subdomain.
vercel dns add example.com '' MX inbound-smtp.us-east-1.amazonaws.com 10
# Safer: use a subdomain for inbound routing
vercel dns add example.com inbound MX inbound-smtp.us-east-1.amazonaws.com 10
# Add SPF record
vercel dns add example.com '' TXT 'v=spf1 include:amazonses.com ~all'
Add DKIM Records for Email Authentication
# DKIM CNAME records (common for SES, Google Workspace, etc.)
vercel dns add example.com selector._domainkey CNAME selector.dkim.provider.com
Add Domain Verification TXT Record
# Google/AWS/other service verification
vercel dns add example.com _amazonses TXT 'verification-token-here'
vercel dns add example.com '' TXT 'google-site-verification=token'
Subdomain Setup
# Point subdomain to a service
vercel dns add example.com api CNAME api.service.com
vercel dns add example.com app A 192.0.2.1
Troubleshooting
"You don't have permission to list the domain record"
The domain is in a different team. List teams and switch:
vercel teams ls
vercel switch <correct-team-slug>
Domain Not Listed
- Domain might be in a different team/account
- Domain might not have Vercel as nameservers
- Check with
vercel domains ls
Record Not Propagating
- DNS propagation can take up to 48 hours (usually 5-30 minutes)
- Check propagation:
dig +short <record-name> <record-type>or use dnschecker.org - Verify record was added:
vercel dns ls <domain>
Token Saving Tips
Fast Verification With dig
When a third-party UI says "Looking for DNS records", verify what the public internet sees:
dig +short TXT resend._domainkey.example.com
dig +short TXT send.example.com
dig +short MX send.example.com
dig +short TXT example.com
Tips
- Always check which team you're in before making changes
- Use single quotes around TXT values to preserve special characters
- For apex/root domain records, use empty string
''as subdomain - Record IDs are shown in
vercel dns lsoutput - needed for removal - Some records (like those added by Vercel automatically) cannot be removed
Converted and distributed by TomeVault — claim your Tome and manage your conversions.