Custom domain shows
an error or blank page.
The two most common causes: the CNAME file got deleted from the deploy output, or DNS records haven't propagated yet. Both are fixable in minutes.
Check these two things first
1. Go to your repo on GitHub → Settings → Pages. Is the custom domain still listed? If it disappeared, the CNAME file was overwritten by a deploy. 2. Run nslookup yourdomain.com — if it doesn't return your host's IP, DNS hasn't propagated yet (wait up to 48 hours).
Common causes & fixes
Your build script is deleting _site/ and rebuilding. The CNAME must be copied into _site/ every build — not just the repo root.
New DNS records take 1–48 hours. Use nslookup or dig to check current resolution. Nothing to fix — just wait.
For GitHub Pages: CNAME should point to username.github.io not the repo URL. Check your DNS provider settings.
After pointing your domain, GitHub takes a few minutes to issue a cert. Wait 10–15 min, then check Settings → Pages for the HTTPS option.
Make sure CNAME is copied on every build:
# Your build script must copy CNAME every time: [ -f CNAME ] && cp CNAME _site/CNAME # Verify it's there after building: cat _site/CNAME