Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

how to add github.io page as a domain in jira cloud

Nicketa
Contributor
February 5, 2025

I'm trying to add a domain into my Atlassian Jira.

I want to use free hosting and hence trying to add my https://xxxx.github.io account. But atlassian is saying invalid domain.

Is it possible to add github.io domain to atlassian. I have a static website.

2 answers

1 accepted

0 votes
Answer accepted
Nicketa
Contributor
September 2, 2026

As I've resolved this issue myself, I'm posting the solution here:

When verifying custom domains in Atlassian Organization Administration (admin.atlassian.com > Settings > Domains), Atlassian requires a naked root domain (apex domain) or a subdomain that you own and control DNS records for (via TXT records or HTTPS meta tags).

The input field fails for two primary reasons:

1. Path & Protocol Inclusion: Entering full URLs containing `https://`, subfolders, or filenames (e.g., `https://xyz.github.io/my-repo/index.html`) triggers the syntax validation error. The input field strictly accepts standard domain syntax (e.g., `example.com` or `subdomain.example.com`).
2. Lack of Root Domain Ownership (`github.io`): Atlassian domain verification requires adding a TXT record to the domain's DNS settings or uploading an HTML verification file to the root of the domain. Because `github.io` is owned by GitHub (and subdomains like `xyz.github.io` share shared hosting configurations), you cannot manage DNS TXT records for `github.io`.

Solution: Connect a Custom Domain to GitHub Pages

To verify your static website domain with Atlassian Cloud while continuing to host it on GitHub Pages for free:

  • Step 1: Purchase or Use a Custom Domain
    Acquire a custom domain from any standard registrar (e.g., Namecheap, Cloudflare, GoDaddy) such as `yourcompany.com` or `yourproject.org`.
    • Note: A custom domain is required—either through GitHub or directly on Atlassian. This is necessary to configure CNAME records.
  • Step 2: Configure Custom Domain on GitHub Pages. Update your DNS provider's records according to GitHub's documentation.
  • Step 3: Add and Verify in Atlassian Admin

Verdict:

  •  If you already own a domain and are operating as an organization, configuring domain settings is well worth it to claim accounts and manage domain-level security and compliance.
  • If you only want to test static pages using a free `github.io` domain like I was doing, Atlassian domain verification will not work without owning a custom domain.
0 votes
Mohanraj Thangamuthu
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 5, 2025

Hello, Good day. Are you trying to verify the github domain with your Atlassian cloud instance? . Please share the complete steps that you are following and also the screenshot of the error message. Thanks

Nicketa
Contributor
February 18, 2025

Hello Mohan,

Please find it below:

  • admin.atlassian.com
  • settings
  • domains
  • add domain
  • add https://xyz.github.io/<>/index.html
  • Error: Invalid domain. Enter the domain using the format example.com

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
FREE
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events