Quickstart for GitHub Pages

You can use GitHub Pages to showcase open source projects, host a blog, or even share your résumé. This guide will help get you started on creating your next website.

Who can use this feature?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. See GitHub's plans.

In this article

Introduction

In this guide, you'll create a user site at <username>.github.io.

Creating your website

  1. In the upper-right corner of any page, select , then click New repository.

    Screenshot of a GitHub dropdown menu showing options to create new items. The menu item "New repository" is outlined in dark orange.

  2. Enter username.github.io as the repository name. Replace username with your GitHub username. For example, if your username is octocat, the repository name should be octocat.github.io. Screenshot of GitHub Pages settings in a repository. The repository name field contains the text "octocat.github.io" and is outlined in dark orange.

  3. Choose a repository visibility. For more information, see About repositories.

  4. Toggle Add README to On.

  5. Click Create repository.

  6. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.