Menu
×
   ❮     
     ❯   
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP HOW TO W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING BASH RUST

Git GitHub Pages


Enable GitHub Pages

GitHub Pages lets you publish a website directly from your repository. To enable it:

  1. Create a new repository named your-username.github.io.
  2. Add your website files (like index.html) to the repository.
  3. Push your changes to GitHub.

GitHub Create New Repository

GitHub Pages Naming Rules

Example

git remote add origin https://github.com/your-username/your-username.github.io.git
git push -u origin master

Set Source Branch/Folder

You can choose which branch and folder to publish. By default, GitHub uses main (or master) and the root folder. To change this:

  1. Go to your repository on GitHub.
  2. Click Settings > Pages.
  3. Under Source, select the branch and folder (e.g., main and docs).
  4. Click Save.

View Your Site

After enabling GitHub Pages, your site will be available at https://your-username.github.io/ (or your custom domain).

Navigate to Pages tab, and see your URL

Click the link to see your live site!


Disable GitHub Pages

To turn off your Pages site:

  1. Go to Settings > Pages.
  2. Click Delete or remove the source branch/folder.
  3. Optionally, delete the repository if you no longer need it.

Example

git push origin --delete gh-pages


×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.

Copyright 1999-2025 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.