Explore by product

Adding or removing a custom domain for your GitHub Pages site

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server. For more information, see "GitHub's products."

Before setting up or modifying your custom domain with your DNS provider, you should add or remove the custom domain on GitHub.

There are a couple of reasons your GitHub Pages site might be automatically disabled:

If you downgrade from GitHub Pro to GitHub Free, any GitHub Pages sites that are currently published from private repositories in your account will be unpublished. For more information, see "Downgrading your GitHub billing plan."

If you transfer a private repository to a personal account that is using GitHub Free, the repository will lose access to the GitHub Pages feature, and the currently published GitHub Pages site will be unpublished. For more information, see "Transferring a repository."

If your GitHub Pages site has a custom domain set up and is disabled, you should immediately update or remove your DNS records with your DNS provider to avoid the risk of a domain takeover. Configuring your custom domain with your DNS provider while your GitHub Pages site is disabled could result in someone else hosting a site on one of your subdomains. For more information, see "Using a custom domain with GitHub Pages."