GitHub Pages

About GitHub Pages

GitHub Pages is a static website hosting service that publishes sites directly from a GitHub repository. Users create a repository (either a personal/organization site named username.github.io, or a project repository), add HTML content, and push changes via git or the GitHub.com web editor; the site becomes live at the corresponding github.io URL. One user or organization site is allowed per GitHub account, alongside unlimited project sites.

The service supports building sites from scratch or using pre-built themes selectable through a repository's Settings tab. It also integrates with Jekyll for blogging with Markdown syntax without a database, and supports custom domains through a CNAME file in the repository.

It is intended for GitHub users who want to host personal, organizational, or project documentation sites directly tied to their repositories, using either a git client (command line or GitHub Desktop) or the GitHub.com web interface.

Key features

• Hosts websites directly from a GitHub repository — push changes and they go live
• One user/organization site per account plus unlimited project sites
• Supports custom domains via a CNAME file
• Blogging support through Jekyll with Markdown syntax, no database required
• Pre-built theme chooser for quick site setup, or build from scratch with plain HTML

Frequently asked questions