Cómo configurar un dominio personalizado en GitHub Pages

Respuesta rápida

Para usar un dominio personalizado en GitHub Pages, abre Settings > Pages, escribe el dominio en Custom domain y haz clic en Save. Luego crea un CNAME de www a <user>.github.io, o 4 registros A para el dominio raíz. El plan Free de Convika también conecta tu dominio, con formulario y 90 días de estadísticas.

Poner mi página en mi dominio

Plan Free: sin tarjeta de crédito, 1 dominio personalizado, 1 página en línea y 50 respuestas de formulario a la vista al mes.

En esta página

Para poner un dominio personalizado en un sitio de GitHub Pages, abre Settings > Pages en el repositorio, escribe el dominio en Custom domain y haz clic en Save. Luego agrega los registros DNS en tu proveedor de DNS: un registro CNAME que apunte www a <user>.github.io, o 4 registros A para el dominio raíz, example.com. Los cambios de DNS pueden tardar hasta 24 horas en propagarse, y después seleccionas Enforce HTTPS.

Los pasos y todos los valores DNS de esta página vienen de la documentación de GitHub, leída el 17 de noviembre de 2026. Las pantallas de GitHub están en inglés, así que sus botones se citan en inglés.

Los registros DNS que necesita GitHub Pages

Tu dominioTipo de registroNombreValor
www.example.comCNAMEwww<user>.github.io o <organization>.github.io
Otro subdominio, como blog.example.comCNAMEblog<user>.github.io o <organization>.github.io
El dominio raíz, example.comA (agrega los 4)@185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153
El dominio raíz, con IPv6AAAA (agrega los 4, junto a los registros A)@2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153, 2606:50c0:8003::153
El dominio raíz, si tu proveedor de DNS tiene ALIAS o ANAMEALIAS o ANAME, en lugar de los registros A@<user>.github.io o <organization>.github.io

Tres reglas de la documentación de GitHub ahorran la mayor parte del tiempo:

  • El valor del CNAME no lleva el nombre del repositorio. GitHub dice que el registro siempre debe apuntar a <user>.github.io o <organization>.github.io, sin el nombre del repositorio, también en un sitio de proyecto.
  • Agrega el dominio en GitHub antes de tocar el DNS. GitHub advierte que configurar primero el DNS puede permitir que otra persona aloje un sitio en uno de tus subdominios.
  • Sin registros comodín. GitHub recomienda con firmeza no usar *.example.com, que deja el dominio en riesgo inmediato de que alguien lo tome.

Configurar el dominio personalizado en 5 pasos

Verifica el dominio en tu cuenta

GitHub recomienda verificar el dominio antes de agregarlo al repositorio. Haz clic en tu foto de perfil, luego en Settings, luego en Pages en la barra lateral y en Add a domain. Escribe el dominio, selecciona Add domain y crea el registro TXT que muestra GitHub, llamado _github-pages-challenge-USERNAME.example.com. Cuando el registro esté activo, haz clic en Verify. Conserva el registro TXT: mantiene el dominio verificado, y ninguna otra cuenta de GitHub puede publicar un sitio en él ni en sus subdominios inmediatos.

Agrega el dominio al repositorio

En el repositorio del sitio, haz clic en Settings y luego en Pages, en la sección «Code, planning, and automation». En Custom domain, escribe www.example.com o example.com y haz clic en Save. Si el sitio se publica desde una rama, esto crea un commit que agrega un archivo CNAME en la raíz de la rama de origen. Si se publica con un flujo de GitHub Actions, no se crea ningún archivo CNAME ni hace falta.

Agrega los registros DNS

En tu proveedor de DNS, agrega los registros de la tabla de arriba: un CNAME para un subdominio, o los 4 registros A para el dominio raíz. Si tu proveedor puso un registro por defecto con el mismo nombre, elimínalo primero. GitHub recomienda configurar www junto al dominio raíz: con los dos configurados, GitHub Pages redirige uno al otro.

Comprueba los registros

Los cambios de DNS tardan hasta 24 horas. Para comprobarlos desde una terminal:

dig www.example.com +nostats +nocomments +nocmd
dig example.com +noall +answer -t A

El primero muestra un CNAME hacia <user>.github.io; el segundo, los 4 registros A. Windows no tiene dig: usa Resolve-DnsName en PowerShell.

Activa Enforce HTTPS

De vuelta en Settings > Pages, selecciona Enforce HTTPS. GitHub pide el certificado a Let's Encrypt por su cuenta cuando pasa la comprobación de DNS, y muestra una marca de verificación junto al dominio cuando termina. La opción puede tardar hasta 24 horas en estar disponible.

www, el dominio raíz o los dos

GitHub recomienda usar siempre un subdominio www, aunque también uses el dominio raíz, porque a los subdominios www no les afectan los cambios en las direcciones IP de los servidores de GitHub. Pon como dominio personalizado el que quieres que vean los visitantes, y agrega los registros DNS de los dos:

  • Dominio personalizado www.example.com, más los registros A del dominio raíz: example.com redirige a www.example.com.
  • Dominio personalizado example.com, más el CNAME de www: www.example.com redirige a example.com.

Un dominio personalizado en un sitio de usuario o de organización también se aplica a los sitios de proyecto de esa cuenta: con www.octocat.com en el sitio de usuario, el repositorio octo-project se abre en www.octocat.com/octo-project.

Arreglar un dominio personalizado de GitHub Pages que no funciona

  • El dominio personalizado desaparece después de un despliegue. Una compilación que hace force push a la rama de publicación sobrescribe el archivo CNAME. Guarda el archivo en tu código fuente para que cada compilación lo incluya. Su nombre va todo en mayúsculas, y contiene un solo dominio y nada más.
  • «Domain is already taken». Otro repositorio tiene el dominio. Verifica el dominio en tu cuenta, lo que lo libera de los sitios de otros usuarios, o haz clic en Remove en Custom domain en el otro repositorio.
  • Enforce HTTPS aparece en gris, o «Certificate not yet created». El HTTPS puede tardar hasta una hora después de configurar el dominio. Si se queda atascado, haz clic en Remove junto al dominio, escríbelo otra vez y haz clic en Save, lo que reinicia la solicitud del certificado. Registros A, AAAA, ALIAS o ANAME de más en @, o un segundo CNAME en el subdominio, pueden bloquear el certificado. Si el dominio tiene registros CAA, uno de ellos tiene que permitir letsencrypt.org.
  • El sitio se abre en www pero no en el dominio raíz, o al revés. Al nombre que falla le falta el registro. Agrega los 4 registros A para el dominio raíz o el CNAME para www. No apuntes el CNAME de un subdominio a tu dominio raíz: GitHub dice que eso rompe el HTTPS.
  • Las imágenes o los estilos desaparecen con HTTPS. La página los carga por http://. Cambia esas URL a https://.
  • La dirección antigua se sigue abriendo. Borra la caché del navegador.

Un sitio admite un dominio raíz y un subdominio www. La documentación de GitHub indica que no se admiten más de un dominio raíz, más de un subdominio www, ni un dominio raíz con otro subdominio personalizado en el mismo sitio.

Lo que GitHub Pages pide al sitio que está detrás del dominio

  • Un repositorio público en GitHub Free. Pages está disponible en repositorios públicos con GitHub Free, y en repositorios privados desde GitHub Pro. El sitio publicado es público en los dos casos.
  • Nada de negocios en línea. La página de límites de GitHub dice que Pages no está pensado ni permitido como alojamiento web gratuito para llevar tu negocio en línea, una tienda de comercio electrónico o cualquier otro sitio dirigido sobre todo a facilitar transacciones comerciales o a ofrecer software comercial como servicio (SaaS). GitHub Pages y el uso comercial (en inglés) explica dónde está el límite.
  • Solo archivos. Pages es un servicio de alojamiento de sitios estáticos, así que un formulario de contacto o de registro necesita un servicio aparte.
  • Tamaño y tráfico. Un sitio puede ocupar hasta 1 GB, con un límite flexible de ancho de banda de 100 GB al mes. Los límites de GitHub Pages (en inglés) recoge el resto.

Un dominio personalizado con formulario y estadísticas de visitas: Convika

Una página que recibe registros, reservas o pedidos necesita algo más que los archivos en línea. En Convika, el plan Free conecta tu dominio a una página que subes, sin repositorio y sin compilación, y el uso comercial está permitido en todos los planes.

Convika FreeGitHub Pages
Qué publicasUn archivo HTML, una carpeta o un ZIP, subidos desde el navegador, o el código pegado desde un chat de IAArchivos en un repositorio de GitHub; público en GitHub Free
Dominio personalizado1, como www.yourbrand.comUn subdominio o el dominio raíz
Registros DNSUn CNAME y un TXT para www; un registro A envía yourbrand.com hacia élUn CNAME para www; 4 registros A para el dominio raíz; un TXT para verificar
HTTPSSe emite solo cuando se encuentran los registrosSe emite solo; seleccionas Enforce HTTPS
Un sitio que vendePermitido en todos los planesNo permitido para un negocio en línea ni una tienda
Un formulario que guarda las respuestasSí: se guardan, te llegan por correo y se exportan en CSV o JSON; 50 al mes a la vistaSolo archivos
Estadísticas de visitasVisitas, sitios de origen, campañas UTM, dispositivos, países y clics en botones durante 90 díasNo aparece en su documentación
Precio0 US$, con la barra de Convika; Pro cuesta 12 US$ al mesGratis

Para llevar una página allí, descarga su index.html del repositorio, o la carpeta con su CSS y sus imágenes, y suéltala en el cuadro para subir de Convika. Haz clic en Conservar esta página: gratis, sin tarjeta, luego en Publicar la página, Pública, Siguiente y Publicar gratis. En la pantalla de la página, haz clic en Connect my domain [Conectar mi dominio; el panel muestra este botón en inglés], agrega www.yourbrand.com y sustituye el CNAME que apunta a <user>.github.io por el que muestra Convika. Poner una página en tu propio dominio (en inglés) recorre cada pantalla, y el código de un formulario de contacto en HTML (en inglés) tiene un formulario para copiar.

Para ver más servicios, consulta alternativas a GitHub Pages (en inglés).

Skipbox

Cheap & fast GitHub Actions runners, unlimited for $39 a month

Your own machine keeps Docker layers and package caches between jobs. Switch by changing one runs-on line.

Start a free Skipbox trial⁠

Preguntas frecuentes

¿Puedo usar gratis un dominio personalizado con GitHub Pages?

Sí. GitHub Pages conecta un dominio personalizado sin costo, desde un repositorio público en GitHub Free. Solo pagas el dominio a tu registrador. El plan Free de Convika también conecta 1 dominio personalizado, con formulario y estadísticas de visitas, a partir de un archivo HTML que subes.

¿Qué registros DNS necesita GitHub Pages?

Para www u otro subdominio, un registro CNAME que apunte a <user>.github.io. Para el dominio raíz, 4 registros A: 185.199.108.153, 185.199.109.153, 185.199.110.153 y 185.199.111.153, o un registro ALIAS o ANAME que apunte a <user>.github.io. Para IPv6, agrega los 4 registros AAAA junto a los registros A.

¿Cuánto tarda en funcionar un dominio personalizado en GitHub Pages?

Hasta 24 horas. La documentación de GitHub dice que los cambios de DNS pueden tardar hasta 24 horas en propagarse, que el HTTPS puede tardar hasta una hora después de configurar el dominio, y que la opción Enforce HTTPS puede tardar hasta 24 horas en estar disponible.

¿Por qué no puedo activar Enforce HTTPS en GitHub Pages?

El certificado todavía no se ha emitido. Espera hasta una hora después de configurar el dominio. Si sigue sin estar disponible, quita el dominio personalizado y agrégalo otra vez para reiniciar la solicitud, borra los registros A, AAAA o CNAME de más con el mismo nombre, y comprueba que cualquier registro CAA permita letsencrypt.org. El nombre de dominio completo tiene que tener menos de 64 caracteres.

¿El registro CNAME debe apuntar a la URL de mi repositorio?

No. Apúntalo a <user>.github.io o <organization>.github.io, sin el nombre del repositorio, también en un sitio de proyecto. GitHub también dice que no lo apuntes a la dirección *.pages.github.io que aparece en la configuración de Pages del repositorio.

¿Puedo usar un dominio personalizado en GitHub Pages con un repositorio privado?

Desde GitHub Pro. En GitHub Free, Pages solo funciona en repositorios públicos. El sitio en sí es público en internet en los dos casos. GitHub Pages y los repositorios privados (en inglés) tiene los detalles.

¿Puedo usar un dominio personalizado de GitHub Pages para el sitio de mi negocio?

GitHub dice que Pages no está permitido para llevar tu negocio en línea, una tienda de comercio electrónico ni un SaaS. El plan Free de Convika permite el uso comercial y conecta tu dominio a los mismos archivos HTML, con un formulario que guarda cada consulta.

¿Puedo conectar más de un dominio a un sitio de GitHub Pages?

Un dominio raíz y su subdominio www, que se redirigen entre sí. La documentación de GitHub indica que no se admite más de un dominio raíz, ni un dominio raíz con otro subdominio personalizado, y el archivo CNAME contiene un solo dominio.

Fuentes

Todas son de GitHub Docs, leídas en inglés el 17 de noviembre de 2026. Las páginas no muestran fecha.

Tu dominio, con un formulario que guarda cada respuesta

Sube el archivo HTML, publícalo gratis y conecta www.yourbrand.com con 2 registros DNS. Sin repositorio, y el HTTPS es automático.

Poner mi página en mi dominio

Plan Free: sin tarjeta de crédito, 1 dominio personalizado, 1 página en línea y 50 respuestas de formulario a la vista al mes.