Subdomain Provisioning for Multi-Tenant Setup on Vercel

Help
, ,
1

Current Setup

  • Backend (API) hosted on Utho → api.maindomain.com

  • Admin (Staging) hosted on Vercel → stage.maindomain.com

  • Admin (Production) hosted on Vercel → ls.``maindomain``.com, spiral.maindomain.com

  • Public Site hosted on Vercel → maindomain.com

Problem

  • The system is multi-tenant.

  • When a new tenant is created, the platform registers a new subdomain on Vercel automatically via Vercel’s API.

  • Example: Creating a new tenant on the staging site → stage2.``maindomain.com.

  • However, for the new subdomain to work, Vercel requires CNAME and TXT DNS records to be added in GoDaddy (domain registrar).

  • Currently, this DNS step is manual (adding records for every new tenant).

  • This is not scalable, since tenants are supposed to self-register and instantly access their subdomain without waiting for DNS updates.

Requirement

  • Implement a solution where new tenant subdomains work automatically, without manually adding CNAME/TXT records in GoDaddy each time.

  • Ensure the DNS setup and Vercel domain registration are fully automated, so the tenant onboarding process is seamless.

Do you want me to also outline possible solutions (e.g., wildcard subdomain, programmatic DNS API integration with GoDaddy, or moving DNS management to Vercel)?

2

The domain troubleshooting guide can help with most custom domain configuration issues. You might be able to use that guide to solve it before a human is available to help you. Then you can come back here and share the answer for bonus points.

You can also use v0 to narrow down the possibilities.

5

Hi @abhishekspiral-1007, welcome to the Vercel Community!

I think using Wildcard domain setup will be ideal for your use case. The following docs will guide you on how to set this up:

We also have a Platforms Starter Kit project to that you can use as a guide for application level implementation.