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

[Nicketa]

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.

[Nicketa · Accepted solution]

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.

[Mohanraj Thangamuthu]

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]

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