> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/custom-domains.md).

# Custom domains

**Custom domains in Jira allow organizations to use a branded URL instead of the default \*.atlassian.net address. Even if a Jira instance has a custom domain configured, proper protection requires adding the organization to Xopero ONE using the original Atlassian URL.**

***

## General information

**Jira** instances that use custom domains can be integrated with **Xopero ONE**, but must use their original **Atlassian** URL instead of the custom domain. This limitation results from how **Atlassian** identifies and authorizes organizations.

**Atlassian** security and administration APIs are bound to the organization's original **Atlassian**-managed URL (e.g., <kbd>yourcompany.atlassian.net</kbd>), not the custom domain. The custom domain serves as a user-facing alias for access and branding purposes.

Internally, **Atlassian** recognizes, authenticates, and grants permissions only through the original URL registered in **Atlassian Administration** ([https://admin.atlassian.com](https://admin.atlassian.com/)). Therefore, **Xopero ONE** must use the original **Atlassian** URL to identify the organization and its applications, authenticate API requests, and enforce security and access controls.

Using the custom domain would prevent proper authorization and could lead to failed connections or incomplete protection, which is why the original **Atlassian** URL is required even when a custom domain is configured.

***

## Finding the original instance URL

You can find organization's original URL in <https://admin.atlassian.com> > **Apps** > **App URLs** > **Custom domains** > **Actions** > **Show details**.

<figure><img src="/files/0yezbgoYm8wSJm4lGudL" alt=""><figcaption></figcaption></figure>

The original URL is listed in the **Details** section under **Default URL (fallback)**.

<figure><img src="/files/lpngQGGxbrf8sFb3L1ij" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/backup-and-recovery/jira/integration/custom-domains.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
