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.
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
- Los registros DNS que necesita GitHub Pages
- Configurar el dominio personalizado en 5 pasos
- www, el dominio raíz o los dos
- Arreglar un dominio personalizado de GitHub Pages que no funciona
- Lo que GitHub Pages pide al sitio que está detrás del dominio
- Un dominio personalizado con formulario y estadísticas de visitas: Convika
- Preguntas frecuentes
- Fuentes
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 dominio | Tipo de registro | Nombre | Valor |
|---|---|---|---|
www.example.com | CNAME | www | <user>.github.io o <organization>.github.io |
Otro subdominio, como blog.example.com | CNAME | blog | <user>.github.io o <organization>.github.io |
El dominio raíz, example.com | A (agrega los 4) | @ | 185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153 |
| El dominio raíz, con IPv6 | AAAA (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 ANAME | ALIAS 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.ioo<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.comredirige awww.example.com. - Dominio personalizado
example.com, más el CNAME dewww:www.example.comredirige aexample.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 permitirletsencrypt.org. - El sitio se abre en
wwwpero 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 parawww. 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 ahttps://. - 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 Free | GitHub Pages | |
|---|---|---|
| Qué publicas | Un archivo HTML, una carpeta o un ZIP, subidos desde el navegador, o el código pegado desde un chat de IA | Archivos en un repositorio de GitHub; público en GitHub Free |
| Dominio personalizado | 1, como www.yourbrand.com | Un subdominio o el dominio raíz |
| Registros DNS | Un CNAME y un TXT para www; un registro A envía yourbrand.com hacia él | Un CNAME para www; 4 registros A para el dominio raíz; un TXT para verificar |
| HTTPS | Se emite solo cuando se encuentran los registros | Se emite solo; seleccionas Enforce HTTPS |
| Un sitio que vende | Permitido en todos los planes | No permitido para un negocio en línea ni una tienda |
| Un formulario que guarda las respuestas | Sí: se guardan, te llegan por correo y se exportan en CSV o JSON; 50 al mes a la vista | Solo archivos |
| Estadísticas de visitas | Visitas, sitios de origen, campañas UTM, dispositivos, países y clics en botones durante 90 días | No aparece en su documentación |
| Precio | 0 US$, con la barra de Convika; Pro cuesta 12 US$ al mes | Gratis |
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 trialPreguntas 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.
Artículos relacionados
- Alternativas a Netlify en 2026: 5 servicios comparados por lo que dan gratisConvika, Cloudflare Pages, Vercel, GitHub Pages y Render frente a Netlify: límites gratis, dominio propio, formularios y precios al 17 de noviembre de 2026.
- Cómo compartir un archivo HTML como un enlace que se abra en cualquier teléfonoSube el archivo a un servicio y envía su enlace; el correo y Google Drive envían el código. 8 servicios comparados, de Convika a Netlify Drop, con 4 pasos.
- Cómo publicar gratis una página HTML de ChatGPT como página web en líneaCompara Convika, Netlify Drop, GitHub Pages, Cloudflare Pages, Tiiny Host y ChatGPT Sites: límites gratis, dominios y formularios. Luego publica la tuya.
- Cómo compartir un artefacto de Claude como enlace o publicarlo en una dirección web realLa mayoría de los enlaces para compartir de Claude se abren sin cuenta. En Claude Free, o para un formulario, tu dominio o visitas, publica el código.