Migrating the Zendesk Jira integration when moving Jira instances

<body>
<p id="docs-hc-snippet" style="display: none;">This article describes the process for migrating the Zendesk Support for Jira integration when moving Jira instances, such as migrating from Jira Server to a Jira Cloud instance.</p>
<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>

<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>

</div>
<div id="docs-ai-summary">
<p id="docs-ai-summary-toggle">Summary: <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">You can migrate the Jira integration by maintaining issue key data and using a migration tool to update links when moving Jira instances. Disconnect the integration from the old instance, install it on the new one, then migrate links to restore ticket connections. The migration process runs in the background and may take up to an hour, allowing continued use of other integration features during this time.</p>
</div>

<div class="body">

<p class="p">This article describes the process for migrating the Zendesk Support for Jira integration
when moving Jira instances, such as migrating from Jira Server to a Jira Cloud
instance.</p>
<div class="p">This article covers the following topics:<ul class="ul" id="topic_lmt_xft_qpb__ul_jvx_fgt_qpb">
<li class="li"><a class="xref" href="#topic_gcw_ywx_ypb">Requirements</a></li>
<li class="li"><a class="xref" href="#topic_k3w_bxx_ypb">Migrating the Zendesk Support for Jira integration</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_gcw_ywx_ypb">
<h2 class="title topictitle2" id="ariaid-title2">Requirements</h2>
<div class="body">
<p class="p">You must maintain Jira issue key data when transferring Jira issues between Jira
accounts. Additionally, your Jira instance must be public (not behind a firewall)
for Zendesk to migrate your links between Jira instances.</p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_k3w_bxx_ypb">
<h2 class="title topictitle2" id="ariaid-title3">Migrating the Zendesk Support for Jira integration</h2>
<div class="body">
<p class="p">Migrating the integration consists of installing and configuring the Zendesk
integration in the new Jira instance, then using the migration tool in Jira to
update links from the old instance to the new one.</p>
<p class="p"><strong class="ph b">To migrate the Zendesk Support for Jira integration</strong></p>
<div class="p">
<ol class="ol" id="topic_k3w_bxx_ypb__ol_bsd_mw5_qpb">
<li class="li">Following Atlassian's recommendations, create a new Jira instance and
migrate your data from the old Jira instance. For more information, see
<a class="xref" href="https://support.atlassian.com/migration/resources/" target="_blank">Migrate your Atlassian Server to
Cloud</a>. <div class="p">
<div class="note important" id="topic_k3w_bxx_ypb__note_cky_r35_ypb">
<span class="importanttitle">Important:</span> Ensure that you maintain
the Jira issue ID and issue key data during the migration.</div>
</div>
</li>
<li class="li">In Jira administration, disconnect the current Zendesk Support for Jira
integration.<ol class="ol" id="topic_k3w_bxx_ypb__ol_qvg_nk5_ypb" type="a">
<li class="li">Click the <strong class="ph b">Settings</strong> cog, then select <strong class="ph b">Apps</strong> &gt;
<strong class="ph b">Manage apps</strong> &gt; <strong class="ph b">Zendesk Support for JIRA</strong> &gt;
<strong class="ph b">Configure</strong> &gt; <strong class="ph b">Settings</strong>.</li>
<li class="li">On the Settings page, click <strong class="ph b">Disconnect</strong> at <strong class="ph b">Zendesk Support
URL</strong>.</li>
<li class="li">Click <strong class="ph b">Save</strong>.<div class="p">
<br><img class="image img-screenshot" id="topic_k3w_bxx_ypb__image_trm_vvb_zpb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/jira_zendesksupport_settings_disconnect.png" width="675"><br>
</div>
</li>
</ol>
</li>
<li class="li">Install and configure the Zendesk Support for Jira integration on the new
instance. See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837969946" target="_blank">Setting up the Zendesk Support for Jira
integration</a>.</li>
<li class="li">After installing the integration on the new Jira instance, migrate links
from the disconnected Jira instance to the new instance.<ol class="ol" id="topic_k3w_bxx_ypb__ol_afv_3zv_jyb" type="a">
<li class="li">In Jira administration, navigate to <strong class="ph b">Apps</strong> &gt; <strong class="ph b">Manage
apps</strong> &gt; <strong class="ph b">Zendesk Support for JIRA</strong> &gt;
<strong class="ph b">Configure</strong> &gt; <strong class="ph b">Link Migration</strong>. The previously
connected Jira instances display in a list. <div class="p">
<br><img class="image img-screenshot" id="topic_k3w_bxx_ypb__image_vdf_pzv_jyb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/jira_migrate_links.png" width="675"><br>
</div>
</li>
<li class="li">Click <strong class="ph b">Migrate links</strong> for each previously connected Jira
instance. The link transfer processes and restores the ticket
links.</li>
</ol>
</li>
</ol>
</div>
<p class="p">You can track the migration process here. It may take up to an hour, depending on the
number of links. You can continue using all other integration features while the
migration progresses. When the migration is complete, the previously connected Jira
instance displays <strong class="ph b">100% complete</strong>. </p>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408830699546-Migrating-the-Zendesk-Jira-integration-when-moving-Jira-instances-Legacy",
"url": "https://support.zendesk.com/hc/en-us/articles/4408830699546-Migrating-the-Zendesk-Jira-integration-when-moving-Jira-instances-Legacy",
"headline": "Migrating the Zendesk Jira integration when moving Jira instances",
"description": "You can migrate the integration between your support system and Jira when moving Jira instances by maintaining issue key data, disconnecting the old integration, installing the integration on the new instance, and using the migration tool to update links.",
"articleSection": "Jira integration",
"datePublished": "2021-10-16T03:43:25+00:00",
"dateModified": "2026-04-30T17:09:41.615186+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408830699546-Migrating-the-Zendesk-Jira-integration-when-moving-Jira-instances-Legacy"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"url": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"url": "https://support.zendesk.com/hc/en-us"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk"
}
}</script><script id="ai-summary-script">
//<![CDATA[
const ai_summary_style = document.createElement('style');
ai_summary_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-ai-summary{background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 6px;margin-bottom:16px}#article-body #docs-ai-summary #docs-ai-summary-toggle{font-size:.9em;font-weight:700;margin-bottom:4px;cursor:pointer;display:flex;justify-content:space-between;align-items:center}#article-body #docs-ai-summary #docs-ai-summary-toggle #up-triangle{margin-left:auto;padding-right:10px;display:none}#article-body #docs-ai-summary #docs-ai-summary-toggle #down-triangle{margin-left:auto;padding-right:10px}#article-body #docs-ai-summary #docs-ai-summary-content{font-size:.9em;padding-left:25px;padding-right:25px;margin-bottom:12px}`;
document.head.appendChild(ai_summary_style);

const toggleAISummary = () => {
const summary = document.getElementById("docs-ai-summary-content");
const upTriangle = document.getElementById("up-triangle");
const downTriangle = document.getElementById("down-triangle");
if (summary.style.display === "none") {
summary.style.display = "block";
upTriangle.style.display = "none";
downTriangle.style.display = "inline";
} else {
summary.style.display = "none";
upTriangle.style.display = "inline";
downTriangle.style.display = "none";
}
};

document.getElementById("docs-ai-summary-toggle").addEventListener("click", toggleAISummary);
//]]>
</script>
</body>