How to Add a Custom Domain to Your Github Pages?

Published on: March 2, 2022

Reading time: 1 min

I have to admit, I was struggling with getting my Github Pages to use my custom domain. In fact is extremely easy, I have to say I have no idea why I was struggling really.


  1. A custom domain (the provider doesn’t really matter, just make sure you can change the DNS records)
  2. An active Github page, in the form [username] or [project]

Set DNS records

Every major Domain provider has it’s own way of setting up a new DNS record, but it’s really straightforward. All you need to do is set A & CNAME records for the selected domain.

You have to add 4 A pointing to @ record from this list:


And then add a CNAME record with the name www pointing to your [username] page:


Your dashboard should end up looking like this.

Add custom domain in Github

Now you are ready to go. Go to your project and in the settings tab there is the option of setting up your custom domain. Just type your domain and click save.


Now just wait up to 24 hours for the DNS to propagate. If you don’t see any changes you can troubleshoot with the Github Pages documentation.

Edit this page on Github

Share this article

0 Tweets