thumb GitHub Pages is an incredibly simple, user-friendly solution for hosting a simple personal website. By default the address will be Below, I’ll explain how I set up my user page with my own domain name that registered trough

Step 1. Set up your user page and register a domain name

I’ll assume this is done. In my case, I set up a user page at When I navigated to that page, the URL stayed as (i.e., it didn’t redirect to anywhere). Also, through, I registered the domain name Now I want to point the custom domain name (in my case is - to my GitHub page.

Step 2. Commit the CNAME file to GitHub page

a) Login to your GitHub Account.

b) Go to the root of your page directory, in my case is -

c) Create a new file named CNAME (all caps, no extension).

d) Put the domain name in your file, in my case is - (without http://, only apex domain or with subdomain like www.).

github & godaddy

e) Commit and push your changes.

Note: You can use a subdomain www. together with an apex domain. This is configured using the CNAME file. For example:

  • If your CNAME file contains, then will redirect to
  • If your CNAME file contains, then will redirect to

Note: By similar way you can add the file robots.txt to your GitHub page.

Step 3. Configure the DNS in GoDaddy

a) Login to your GoDaddy Account.

b) Go to “Manage Your Domains”.

c) Choose the domain name that you want to point to your page.

d) Click on the “DNS Zone File” tab. github & godaddy

e) Under the “A (Host)” section add a two A-records:

  • First: “A (Host)” record with host = @ and Points to =
  • Second: “A (Host)” record with host = @ and Points to =

github & godaddy

This is explained there.

f) Under the “CName (Alias)” section add a “CNAME (Alias)” record with host = www and Points to = (in my case is

github & godaddy

g) Save changes.

That’s all I did with GoDaddy. I didn’t change anything else, including the Nameserver (NS) records.

Step 4. Testing

Changes require some time and do not take effect immediately. Patiently wait for your DNS settings to update. It can take up to 48 hours.

When the DNS updates, you should be able to navigate to your custom domain and see your page, but now with custom domain name.

You can check your work with the following command:

dig +nostats +nocomments +nocmd
;   73  IN  A   73  IN  A

Congratulations, now you know how to add the custom domain name (URL) to GitHub pages. You can check my GitHub page at

Arthur Gareginyan

Arthur Gareginyan

Arthur is a designer and full stack software engineer. He is the founder of His personal website can be found at Check out his free WordPress plugins at

Follow Arthur: