Custom Domain
Every Teta app gets a default .vercel.app URL, but you can connect your own domain to give your app a professional, branded address. Custom domains work with both apex domains (example.com) and subdomains (app.example.com).
Why Custom Domains Matter
A custom domain makes your app look professional and trustworthy. Instead of sharing my-project-xyz.vercel.app, you share myapp.com. Custom domains also help with:
- Brand identity - Your domain reinforces your brand.
- SEO - Search engines treat custom domains more favorably than subdomain URLs on shared platforms.
- User trust - Visitors are more likely to trust a dedicated domain.
- Email consistency - Your app domain can match your email domain for a cohesive brand presence.
Adding a Domain
To connect a custom domain to your Teta app:
- Open your project in Teta.
- Go to Project Settings.
- Navigate to the Domains section.
- Enter your domain name (e.g.,
myapp.comorapp.myapp.com). - Click Add Domain.
Teta will display the DNS records you need to configure at your domain registrar.
DNS Configuration
After adding your domain in Teta, you need to update your DNS settings at your domain registrar (where you bought the domain, such as Namecheap, GoDaddy, Cloudflare, or Google Domains). The exact records depend on whether you are using a subdomain or an apex domain.
Subdomain (e.g., app.myapp.com)
For subdomains, add a CNAME record:
| Type | Name | Value |
|---|---|---|
| CNAME | app | cname.vercel-dns.com |
Replace app with your chosen subdomain. The value cname.vercel-dns.com points your subdomain to Vercel's infrastructure.
Apex Domain (e.g., myapp.com)
For apex (root) domains, add an A record pointing to Vercel's IP address:
| Type | Name | Value |
|---|---|---|
| A | @ | 76.76.21.21 |
Some registrars use @ to represent the apex domain, while others leave the name field empty. Check your registrar's documentation if you are unsure.
If your registrar supports it, you should also add a CNAME record for the www subdomain to handle both myapp.com and www.myapp.com:
| Type | Name | Value |
|---|---|---|
| CNAME | www | cname.vercel-dns.com |
TXT Records for Verification
In some cases, Teta may ask you to add a TXT record to verify domain ownership. This looks like:
| Type | Name | Value |
|---|---|---|
| TXT | _vercel | vc-domain-verify=your-app-id... |
Add this record alongside your CNAME or A record. Verification typically completes within a few minutes.
Verification Process
After updating your DNS records, Teta will check the configuration:
- Pending - DNS records have been submitted but not yet detected. This is normal immediately after making changes.
- Verifying - Teta has detected the DNS records and is verifying they are correct.
- Active - The domain is verified and connected. Your app is accessible at the custom domain.
- Error - There is a problem with the DNS configuration. Check the error message for details.
You can check the verification status in your project's domain settings. If verification is taking longer than expected, see the troubleshooting section below.
SSL and HTTPS
SSL certificates are provisioned automatically once your domain is verified. You do not need to purchase, upload, or configure any certificates. Teta and Vercel handle everything:
- Certificates are issued via Let's Encrypt.
- HTTPS is enabled by default on all custom domains.
- Certificates renew automatically before they expire.
- HTTP requests are automatically redirected to HTTPS.
Your visitors will always see the padlock icon in their browser, indicating a secure connection.
Multiple Domains
You can connect more than one domain to a single Teta app. This is useful for:
- Having both
myapp.comandwww.myapp.compoint to your app. - Supporting different regional domains (e.g.,
myapp.co.ukalongsidemyapp.com). - Running a rebrand where you want both the old and new domain to work during the transition.
Add each domain separately in the Domains section of your project settings. Each domain needs its own DNS configuration.
One domain will be the primary domain, and others will redirect to it. You can change which domain is primary in the settings.
Troubleshooting DNS Propagation
DNS changes can take time to propagate across the internet. Here are common issues and solutions:
Changes not detected after 10 minutes. DNS propagation can take up to 48 hours in rare cases, but most changes propagate within 5 to 30 minutes. Verify your records are correct by using an online DNS checker tool.
CNAME conflict on apex domain. Some DNS providers do not allow CNAME records on apex domains (this is technically correct per the DNS specification). Use an A record instead, or check if your provider supports CNAME flattening (Cloudflare does this automatically).
Existing records conflict. If you already have A or CNAME records for the same domain, remove or update them. Conflicting records will prevent verification.
Cloudflare proxy. If you use Cloudflare, set the DNS record to "DNS only" (grey cloud, not orange) during setup. You can enable the Cloudflare proxy later once the domain is verified, but it may interfere with the initial verification.
Registrar propagation delay. Some budget registrars have slower propagation. If your changes are not taking effect, check that you saved the DNS changes correctly in your registrar's control panel.
FAQ
How long does DNS propagation take?
Most DNS changes propagate within 5 to 30 minutes. In rare cases involving certain registrars or geographic regions, it can take up to 48 hours. You can use online tools like dig or DNS checker websites to verify your records have propagated.
Can I use a domain I bought from any registrar?
Yes. Custom domains work with any domain registrar. You just need the ability to edit DNS records for your domain. This includes Namecheap, GoDaddy, Google Domains, Cloudflare, Route 53, and any other registrar.
What happens if I remove a custom domain?
Removing a domain from your project settings disconnects it from your app. The domain stops resolving to your Teta app. Your app remains accessible at its default .vercel.app URL. You can re-add the domain later if needed.
Can I use a subdomain without owning the apex domain?
You need to own (or have DNS control over) the parent domain to create subdomain records. If you own myapp.com, you can create anything.myapp.com as a subdomain pointing to your Teta app.
Is there a limit on the number of custom domains?
You can add multiple custom domains to a single project. For most use cases, two or three domains (apex, www, and possibly a regional variant) are sufficient. Check your plan details for specific limits.