GitHub Pages

Create a site or blog from your GitHub repositories with GitHub Pages.

Welcome

• Who is this for: Beginners, students, project maintainers, small businesses.

• What you'll learn: How to build a GitHub Pages site.

• What you'll build: We'll build a simple GitHub Pages site with a blog. We'll use Jekyll, a static site generator.

• Prerequisites: If you need to learn about branches, commits, and pull requests, take Introduction to GitHub first.

• How long: This exercise takes less than one hour to complete.

In this exercise, you will:

1. Enable GitHub Pages
2. Configure your site
3. Customize your home page
4. Create a blog post
5. Merge your pull request

How to start this exercise

Simply copy the exercise to your account, then give your favorite Octocat (Mona) about 20 seconds to prepare the first lesson, then refresh the page.

Having trouble? 🤷

When copying the exercise, we recommend the following settings:

• For owner, choose your personal account or an organization to host the repository.

• We recommend creating a public repository, since private repositories will use Actions minutes.

If the exercise isn't ready in 20 seconds, please check the Actions tab.

• Check to see if a job is running. Sometimes it simply takes a bit longer.

• If the page shows a failed job, please submit an issue. Nice, you found a bug! 🐛

---

© 2025 GitHub • Code of Conduct • MIT License