Tutorial: Cómo conectar un subdominio personalizado a un proyecto desplegado en Vercel

En este tutorial aprenderás a conectar un subdominio personalizado a un proyecto que ya tienes desplegado en Vercel, usando un registro DNS tipo CNAME.

La idea es que tu proyecto pueda abrirse desde una dirección como esta:

Por ejemplo, si tu dominio fuera:

y quisieras crear el subdominio:

entonces la dirección final sería:

En tu caso deberás reemplazar gabrielgomez.site por tu propio dominio.

1. Conceptos básicos

Antes de configurar el dominio, conviene entender qué significa cada parte.

Dominio principal

Es el dominio base que compraste o administras.

Ejemplo:

En tu caso sería algo como:

Subdominio

Es una palabra o nombre que se coloca antes del dominio principal.

Ejemplo:

Al unirlo con el dominio principal, queda así:

Registro CNAME

Un registro CNAME sirve para indicar que un subdominio debe apuntar hacia otro dominio o servicio.

En este caso, el subdominio apuntará a Vercel.

Ejemplo:

2. Agregar el dominio en Vercel

Primero debes entrar al proyecto que tienes desplegado en Vercel.

Ve a:

Después da clic en:

Ahí escribe el subdominio completo que quieres conectar.

Ejemplo:

En tu caso deberás escribir:

Por ejemplo:

Después de agregarlo, Vercel revisará si el DNS ya está configurado. Si todavía no lo está, mostrará un aviso parecido a:

o:

No te preocupes, eso significa que falta agregar el registro DNS en tu proveedor de dominio.

3. Obtener el valor CNAME desde Vercel

Después de agregar el dominio en Vercel, la plataforma te mostrará una tabla con los datos que debes configurar en tu DNS.

Normalmente se verá parecido a esto:

El dato más importante es el Value o Target.

Ejemplo:

En algunos casos, Vercel puede mostrarte un valor más específico, parecido a este:

Ese valor debes copiarlo exactamente como aparece.

4. Entrar al panel DNS de tu dominio

Ahora debes entrar al proveedor donde administras tu dominio. Puede ser:

En este ejemplo usaremos la lógica general de Namecheap, pero el proceso es muy parecido en otros proveedores.

Busca una sección llamada algo similar a:

5. Crear el registro CNAME

Agrega un nuevo registro DNS con estos datos:

Ejemplo práctico

Supongamos que tu dominio es:

Y quieres crear el subdominio:

Entonces el dominio final será:

En tu DNS deberías agregar algo así:

O, si Vercel te dio un valor personalizado:

6. Importante: qué poner en “Host”

Este punto suele causar confusión.

Si el dominio completo será:

En el campo Host no debes poner todo el dominio completo.

Incorrecto:

Correcto:

Esto es porque el panel DNS ya sabe que estás editando el dominio principal:

Por eso solo debes escribir la parte del subdominio.

7. Importante: qué poner en “Value”

El campo Value es el destino al que apuntará el subdominio.

Ese valor lo obtienes desde Vercel, en:

Ejemplo común:

Ejemplo personalizado:

Debes copiarlo tal como aparece en Vercel.

Si aparece con punto final, por ejemplo:

puedes dejarlo con el punto final.

8. Guardar el registro DNS

Una vez llenados los campos, guarda el registro.

Tu configuración debería quedar parecida a esta:

No borres otros registros existentes como:

Solo agrega el nuevo registro para tu subdominio.

9. Verificar el dominio en Vercel

Después de guardar el registro DNS, regresa a Vercel:

Busca el dominio que agregaste.

Ejemplo:

Vercel intentará verificar la configuración.

Si todo está correcto, el dominio aparecerá como configurado correctamente.

Puede tardar desde unos minutos hasta varias horas, dependiendo de la propagación DNS.

10. Probar el subdominio

Cuando Vercel marque el dominio como correcto, abre el subdominio en el navegador.

Ejemplo:

En tu caso será:

Si todo está bien, deberías ver tu proyecto desplegado en Vercel.

11. Verificar desde terminal

También puedes verificar el registro DNS desde la terminal.

En Windows

Ejemplo:

En Linux o Mac

Ejemplo:

Si responde con algo como:

o con el valor que te dio Vercel, significa que el DNS ya está apuntando correctamente.

12. Errores comunes

Error 1: Poner el dominio completo en Host

Incorrecto:

Correcto:

Error 2: Confundir CNAME con NS

Para conectar un subdominio a Vercel normalmente necesitas un:

No necesitas un:

El registro NS se usa para delegar servidores de nombres, no para apuntar un subdominio normal a Vercel.

Error 3: No agregar primero el dominio en Vercel

Primero agrega el dominio en:

Luego copia el valor que Vercel te indique y agrégalo en tu proveedor DNS.

Error 4: Borrar registros existentes

No borres registros como:

A menos que sepas exactamente qué hacen.

Para este caso solo necesitas agregar un nuevo registro CNAME.

Resumen final

Para conectar un subdominio a Vercel necesitas hacer esto:

En Vercel

Agregar el dominio completo:

Ejemplo:

En tu DNS

Agregar un registro:

Ejemplo:

Resultado final

Tu proyecto de Vercel quedará disponible desde:

Ejemplo: