Migrating from the legacy Jira integration

<body>
<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">Verified AI summary <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">Upgrade from the legacy Jira integration to access an improved support app and ticket view, better management through Admin Center, and enhanced configuration options. Ensure you have admin access in both systems, and test in a sandbox environment first. After migrating, install the ticket view app, configure webhooks, and manage links via the API. Reverting to the legacy version is possible if needed.</p>
</div>

<div class="body">

<p class="p">Jira Cloud customers using the legacy Zendesk Support for Jira integration should migrate
to the new integration at their earliest convenience.</p>
<p class="p">The new Jira integration for Zendesk offers an enhanced Support app and improved ticket
view in Jira, as described in <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9827173048858" target="_blank">Using the Jira integration for Zendesk</a>. It also provides
enhanced management and configuration through Admin Center. See <a class="xref" href="https://support.zendesk.com/hc/en-us/sections/4405298867866" target="_blank">Jira integration resources</a> for more information.</p>
<div class="p">This article includes the following topics:<ul class="ul" id="jira_migration__ul_kly_wkw_q2c">
<li class="li"><a class="xref" href="#topic_ach_hcp_ghc">Considerations</a></li>
<li class="li"><a class="xref" href="#topic_whm_2jp_ghc">Migrating from the legacy Jira integration</a></li>
<li class="li"><a class="xref" href="#topic_f5z_3jv_ghc">Reverting to the legacy Jira integration</a></li>
<li class="li"><a class="xref" href="#topic_eqv_z25_yhc">Frequently asked questions</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_ach_hcp_ghc">
<h2 class="title topictitle2" id="ariaid-title2">Considerations</h2>
<div class="body">
<ul class="ul" id="topic_ach_hcp_ghc__ul_krm_3cp_ghc">
<li class="li">Data created with the legacy integration migrates <strong class="ph b">only when you open related
tickets or issues</strong> in the new apps. There may be a short delay when
loading data for the first time. </li>
<li class="li">The new Jira integration doesn't support Jira Data Center or Jira Server.
Atlassian is planning to discontinue these platforms. See Atlassian's
announcements for <a class="xref" href="https://www.atlassian.com/migration" target="_blank">Jira Data Center</a> and <a class="xref" href="https://www.atlassian.com/licensing/server-end-of-support#serv-end-of-support" target="_blank">Jira Server</a>.</li>
<li class="li">To run the migration, you must have admin access in both Zendesk Support and
Jira. The migration doesn't transfer or impersonate any legacy users who
authorized the legacy integration.</li>
<li class="li">Zendesk recommends running the migration and testing the new integration in your
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/6150628316058" target="_blank">sandbox environment</a> before
implementing changes in production.</li>
<li class="li">If you currently use a POST function in Jira to notify Zendesk tickets, you must
set this up differently using global automation, as explained in <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/10055291434394" target="_blank">Synchronizing the status of Zendesk tickets
with the status of linked issues in Jira</a>. We recommend reviewing this
information before starting the migration.</li>
<li class="li">After the migration is complete:<ul class="ul" id="topic_ach_hcp_ghc__ul_xy5_mck_hhc">
<li class="li">All Jira integration settings are managed in Admin Center.</li>
<li class="li">Legacy apps are replaced with new ones: the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9810169980058" target="_blank">Jira app for Zendesk Support</a>
and <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9810155413146" target="_blank">Zendesk ticket view for Jira</a>. </li>
<li class="li">The legacy Jira integration is disconnected. You can <a class="xref" href="#topic_f5z_3jv_ghc">revert to the legacy
integration</a> if necessary.</li>
</ul>
</li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_whm_2jp_ghc">
<h2 class="title topictitle2" id="ariaid-title3">Migrating from the legacy Jira integration</h2>
<div class="body">
<p class="p">The migration connects your Jira account to the new integration and retains your
existing configurations.</p>
<p class="p"><strong class="ph b">To migrate from the legacy Jira integration</strong></p>
<div class="p">
<ol class="ol" id="topic_whm_2jp_ghc__ol_ej2_clc_rlb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_whm_2jp_ghc__d8e2083" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_apps_integrations_icon.png">
<strong class="ph b">Apps and integrations</strong> in the sidebar, then select <strong class="ph b">Integrations &gt;
Integrations</strong>.</span></li>
<li class="li">On the Integrations page, click <strong class="ph b">Jira</strong>.</li>
<li class="li">Select <strong class="ph b">Switch to new and improved Jira integration experience</strong>.<div class="p">If
you don't see this option:<ul class="ul" id="topic_whm_2jp_ghc__ul_jty_nxp_ghc">
<li class="li">Verify that you're in the correct Zendesk account.</li>
<li class="li">Check that the Zendesk account is already connected using the
legacy integration. (The migration applies only to existing
connections.)</li>
</ul>
</div>
<div class="p">
<br><img class="image img-screenshot" id="topic_whm_2jp_ghc__image_c4l_x13_rlb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/jira_migrate_option.png" width="600"><br>
</div>
</li>
<li class="li">Select the checkbox to agree to the <strong class="ph b">Built by Zendesk Terms of Use</strong>,
then click <strong class="ph b">Connect Jira</strong>.</li>
<li class="li">Click <strong class="ph b">Connect</strong> on the confirmation page.</li>
<li class="li">In the <strong class="ph b">Use app on</strong> menu, select the Jira account you're
migrating.<p class="p">This step grants Zendesk access to data in your Atlassian
account.</p>
<div class="p">
<br><img class="image img-screenshot" id="topic_whm_2jp_ghc__image_tjz_t4t_wgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/Jira_v2_grant_access.png" width="400"><br>
</div>
</li>
<li class="li">Click <strong class="ph b">Accept</strong>.<p class="p">You are directed back to Admin Center. The migration
is in progress. Your legacy settings and configuration are migrated
automatically during this process, and configuration changes can't be
made during migration. If you try to edit a connection, you'll see the
message below. </p>
<br><img class="image img-screenshot" id="topic_whm_2jp_ghc__image_w1x_whq_ghc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/jira_migration_progress.png" width="400"><br>
</li>
<li class="li">When the migration is complete:<ul class="ul" id="topic_whm_2jp_ghc__ul_l5b_vlp_3hc">
<li class="li">
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9810155413146#topic_v2v_1lw_q2c" target="_blank">Install the Zendesk ticket view
app</a> in Jira Cloud.</li>
<li class="li">
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408821582362" target="_blank">Configure a Jira Cloud webhook
for field syncing</a>.</li>
<li class="li">
<a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/jira_v2/jira_integration_links/" target="_blank">Manage links through the
API</a>.</li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/10055291434394" target="_blank">Sync the status of Zendesk
tickets with the status of linked issues in Jira</a></li>
</ul>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_f5z_3jv_ghc">
<h2 class="title topictitle2" id="ariaid-title4">Reverting to the legacy Jira integration</h2>
<div class="body">
<p class="p">You can revert to the legacy Jira integration, if necessary.</p>
<p class="p"><strong class="ph b">To revert to the legacy Jira integration</strong></p>
<ol class="ol" id="topic_f5z_3jv_ghc__ol_ydn_vnv_ghc">
<li class="li">
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9797104268058#topic_rmq_jkt_sjb" target="_blank">Disconnect your Jira instance</a>.</li>
<li class="li">
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837969946" target="_blank">Reconnect using the legacy
method</a>.</li>
</ol>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested1" id="topic_eqv_z25_yhc">
<h2 class="title topictitle2" id="ariaid-title5">Frequently asked questions</h2>
<div class="body">
<p class="p" dir="ltr"><strong class="ph b">I don't see the migration option. Why?</strong></p>
<p class="p" dir="ltr">The migration option appears only if your legacy integration is still
connected. If the legacy integration is disconnected, use the steps in <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9797104268058" target="_blank">Connecting your Jira instance to Zendesk</a> to install the
new integration.</p>
<p class="p" dir="ltr"><strong class="ph b">I uninstalled the Jira app, but the migration option still appears.
Why?</strong></p>
<p class="p" dir="ltr">Uninstalling the Zendesk Jira app doesn't disconnect the legacy
integration. The legacy integration was set up in Jira. You must <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408837969946#topic_dsy_fys_5pb" target="_blank">disconnect it</a> in Jira.</p>
<p class="p" dir="ltr"><strong class="ph b">I migrated and updated the integration settings. Are these settings
restored if I revert to the legacy integration?</strong></p>
<p class="p" dir="ltr">No. Settings that were stored with the new integration don't revert to the
legacy integration. You may need to manually reconfigure the legacy integration if
you changed settings after migration.</p>
<p class="p" dir="ltr"><strong class="ph b">Can I use both the legacy and new integrations at the same time?</strong></p>
<p class="p" dir="ltr">No. Using both at once will cause problems with data, especially links and
field sync.</p>
</div>
</div>
<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>