# Changing the URL or Transitioning Between Instances

To update your URL or switch instances (e.g., from Jira Cloud to Jira Data Center), Getint offers a straightforward process to adjust connections within integrations for a smooth transition. This guide outlines the necessary steps for changing your URL or transitioning to a new instance.

### **How to Change the URL in Your Integration** <a href="#how-to-change-the-url-in-your-integration" id="how-to-change-the-url-in-your-integration"></a>

If your Jira Cloud URL has changed:

1. Open the option to create an integration in Getint.

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

2. Follow the steps to establish a new connection using the new URL (if you haven't already) and exit the creation tab. For further instructions, refer to our [Connection guide](https://docs.getint.io/guides/quickstart/connection).

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

3. Open the integration you want to modify, click **More > Settings** in the top right, disable it, and save.

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

4. Select the app icon you want to change.

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

5. Choose **Change Connection.**

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

6. Select the new connection and select **Change Connection.**

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

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

7. Save the changes and re-enable the integration.

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

#### **Transitioning Between Jira Instances** <a href="#transitioning-between-jira-instances" id="transitioning-between-jira-instances"></a>

If you’re transitioning between Jira instances, such as moving from Jira Data Center to Jira Cloud:

1. **Create a New Connection**:
   * Set up a new connection with the appropriate URL and credentials for the new Jira instance.
   * Ensure the new connection has the same permissions as the previous one to avoid data sync issues.
2. **Edit the Integration**:
   * Go to the **Integration Editor** and update the connection to point to the newly created one.
3. **Test the Sync**:
   * Verify that data syncs correctly between the new instance and the destination app.

{% hint style="warning" %}
**Warning:**\
Switching from **Jira Data Center to Jira Cloud** (or vice versa) by simply updating the connection **may not work** due to key structural differences between the two platforms, including:\
✔ **Field IDs** – Jira Cloud and Jira Data Center assign different internal IDs to custom and system fields, which may break mappings.\
✔ **Project IDs** – Each Jira instance generates unique project IDs, making direct migration difficult.\
✔ **User IDs** – Jira Cloud uses **Atlassian Accounts**, while Jira Data Center may rely on **internal directories or LDAP**, causing user mismatches.\
✔ **Field Names & Workflows** – Some fields, workflows, and statuses may **not be identical**, leading to synchronization issues or failed updates.

If you’re moving between Jira Cloud and Jira Data Center, we strongly recommend using Getint’s Migration option to ensure a proper migration rather than just changing the connection.
{% endhint %}

#### **When to Use the "Change Connection" Feature** <a href="#when-to-use-the-change-connection-feature" id="when-to-use-the-change-connection-feature"></a>

The **Change Connection** feature is designed to help with:

* **URL Changes**: For example, updating your Jira Cloud instance URL.
* **Account Updates**: Switching from a personal account to a service account.
* **Connection Errors**: Resolving connection-related issues by switching to a new connection.

#### **Best Practices and Considerations** <a href="#best-practices-and-considerations" id="best-practices-and-considerations"></a>

**Pros**:

* Easily update your connection without creating a new integration.
* Seamlessly transition between accounts or fix connection issues without affecting existing data.
* Supports URL changes for the same instance.

**Cons**:

* Ensure the new connection has identical permissions to access fields and issues already synced; otherwise, data sync errors may occur.
* Avoid using this feature for significant changes, like switching projects or migrating between fundamentally different instances (moving to a different app, for example)

{% hint style="info" %}
For more detailed modifications, you can access the **Connections** settings in the **Workflows** section of Getint. Refer to our [Connections Documentation](https://docs.getint.io/getintio-platform/connections) for additional guidance.
{% endhint %}

#### **Conclusion** <a href="#conclusion" id="conclusion"></a>

Getint's connection management features simplify the process of changing URLs or transitioning to a new instance. Ensure the new connection's permissions align with the previous ones to prevent disruptions.

For additional support, reach out to our [Support Portal](https://getint.io/help-center).

<figure><img src="/files/otyodSR2k1YTwh3mrnVq" alt=""><figcaption><p><a href="https://calendly.com/d/cpws-jb2-8xx/demo-call-all-team
">Start your integration journey. Schedule a free consultation with our Getint Integration Expert today!</a></p></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.getint.io/getintio-platform/connections/changing-the-url-or-transitioning-between-instances.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
