github.io

Gotchas

• One user/org subdomain

  Each GitHub account gets exactly one user or organization Pages site at username.github.io; additional projects get project-scoped subpaths, not separate subdomains.

• 100 GB/month bandwidth (soft)

  GitHub Pages enforces a soft 100 GB per month bandwidth limit; sites exceeding this may be throttled or contacted by GitHub support.

• 10 builds per hour

  GitHub Pages has a soft limit of 10 site builds per hour per repository; excess builds may be queued or rejected.

• 1 GB recommended site size

  GitHub recommends keeping the Pages source repository under 1 GB; larger repos may trigger warnings or degraded build performance.

• Static files only — no server-side code

  GitHub Pages only serves static HTML/CSS/JS; there is no server-side runtime, database, or dynamic content generation.

• No custom apex domain without DNS change

  The free subdomain is username.github.io; using a custom apex or branded domain requires external DNS configuration and is a separate concern.

• Not for e-commerce/transactions

  GitHub Pages Terms of Service prohibit running online businesses, e-commerce sites with payment processing, or SaaS products directly on Pages.

• Build timeout of 10 minutes

  GitHub Pages deployments will fail if the site build process exceeds 10 minutes.

• Shared CDN, no SLA

  GitHub Pages is served from a shared CDN with no uptime SLA; performance is generally good but not guaranteed for high-traffic or latency-sensitive use.

• github.io branding in URL

  The free tier subdomain is visibly branded as github.io; removing GitHub from the URL requires configuring a custom domain at the DNS level.