If your GitHub Pages site isn't loading at your custom domain, you may have an error in your GitHub repository setup or your DNS configuration.

Tip: If you've recently changed or removed your custom domain and can't access the new URL in your browser, you may need to clear your browser's cache to reach the new custom domain. For more information on clearing your cache, see your browser's help site.

GitHub repository setup errors

Tip: Custom domains are stored in a CNAME file in the root of your repository. You can add or update your custom domain through your repository settings. You can also edit the file directly to update your custom domain, although we recommend the procedure in "Adding or removing a custom domain for your GitHub Pages site."

The CNAME file isn't properly formatted

  • The CNAME filename must be uppercase
  • Only the bare domain or subdomain should be listed, e.g., example.com or blog.example.com, not https://example.com.

For more information on setting up your custom domain, see "Adding or removing a custom domain for your GitHub Pages site."

Multiple domains in CNAME file

A CNAME file can contain only one domain. To point multiple domains to the same Page, set up redirects through your DNS provider.

CNAME already taken

If your custom domain is already used by another GitHub Pages site, you will receive a page build warning. When you add or edit your custom domain in your GitHub Pages site's repository settings, we automatically create a CNAME file in the root of your repository. A custom domain in a CNAME file can only be used once. Here are some examples of when you'll receive a page build warning for a duplicate custom domain:

  • If you have an apex domain such as example.com in your CNAME file, this means that either example.com or its www subdomain (www.example.com) has been used in a CNAME file in another repository and is being used by the corresponding GitHub Pages site.

  • Likewise, if you have a www subdomain such as www.example.com in your CNAME file, this means that either www.example.com or its apex domain (example.com) has been used in a CNAME file in another repository and is being used by the corresponding GitHub Pages site.

If you own the other GitHub Pages repository that is using your custom domain in its CNAME file, then you must remove the custom domain from your other repository's CNAME file before you can use it in a different pages site repository.

To remove the custom domain from a different GitHub Pages site repository you own, you can add a different custom domain to your GitHub Pages site or just remove your old custom domain.

If you don't own the repository that contains the CNAME file with your custom domain, try to contact the owner and ask them to update their custom domain. If you're unsure which repository contains the CNAME file with your custom domain, contact GitHub Support.

Reached limit for User or Organization pages site

You can only create one User or Organization pages site per GitHub account. For instance, there can only be one Organization pages site per organization account. Likewise, there can only be one User pages site per individual user account. Project pages sites are unlimited.

Wrong publishing branch for Project pages

The publishing branch for Project pages is gh-pages.

Wrong publishing branch for User or Organization pages

The publishing branch for a User or Organization pages site is master.

DNS configuration errors

Tip: If you have trouble pointing your GitHub Pages default domain to your custom domain, then contact your DNS provider for help. They can help confirm that you have configured your custom domain correctly.

DNS record doesn't point to GitHub's server

In order to serve the Page, your DNS records must point to GitHub's server. To confirm that your custom domain points to GitHub's servers, use the dig command with your custom domain. The dig command shows you where your custom domain points. For example:

dig example.com +nostats +nocomments +nocmd
example.com.     3600    IN A     192.30.252.153

In the example above, example.com points to the IP address 192.30.252.153.

If you configured A records through your DNS provider, then your A records should point your custom domain to the following IP addresses:

  • 192.30.252.153
  • 192.30.252.154

Notes:

  • You may see a different IP address, since we serve Pages with a global Content Delivery Network. Use dig username.github.io to see the full resolution path. Note that DNS caching may cause a delay.
  • If you're using an A record that points to 207.97.227.245 or 204.232.175.78, you'll need to update your DNS settings, as we no longer serve Pages directly from those servers.

If you configured ALIAS, ANAME, or CNAME records through your DNS provider, then you your DNS record should point to your GitHub Pages default domain, such as YOUR-GITHUB-USERNAME.github.io. Your default GitHub Pages domain is determined by the type of pages site you have. For examples, see this domain chart.

If you need help creating these records, contact your DNS provider as they should have the most detailed instructions. For some guidelines on configuring a DNS record with DNS providers, see "Using a custom domain with GitHub Pages."

Unsupported custom domain name

If your custom domain is unsupported then you may need to change your custom domain. You can also contact your DNS provider to see if they offer domain name forwarding services to redirect your site to an unsupported custom domain.

Unsupported custom domains include:

  • using more than one apex domain (example.com and anotherexample.com)
  • using more than one www subdomain (www.example.com and www.anotherexample.com)
  • combination of an apex domain and custom subdomain (example.com and docs.example.com)

Danger: Do not use wildcard DNS records (e.g., *.example.com) with GitHub Pages! A wildcard DNS record will allow anyone to host a GitHub Pages site at one of your subdomains.

For a list of supported custom domains, see "About supported custom domains."

URL formatting error on Linux

Warning: If the URL for your Pages site contains a username or organization name that begins or ends in a dash, or contains consecutive dashes, then people browsing with Linux will receive a server error when they visit the site. To fix this, change your GitHub username to remove non-alphanumeric characters. For instructions on how to do this, see "Changing your GitHub username."