Managing configuration deployments between Zendesk environments

<body>
<p id="docs-hc-snippet" style="display: none;">After youdeploy configurationsfrom one Zendesk environment to another in your account, you might need to revert, rename, or otherwise manage the deployment.</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_gpee">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

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

</div>

<div class="body">

<div class="note fastpath">
<span class="fastpathtitle">Location: </span> <span class="ph">Admin Center &gt; Account &gt; Sandbox &gt; Deployments</span>
</div>
<p class="p">After you <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9474556880922" target="_blank">deploy configurations</a> from one Zendesk
environment to another in your account, you might need to revert, rename, or otherwise
manage the deployment.</p>
<div class="p">This article contains the following topics:<ul class="ul" id="topic_as3_cw5_wgc__ul_vtr_3w5_wgc">
<li class="li"><a class="xref" href="#topic_yr1_tg3_xgc">Viewing a deployment's details, source, or destination</a></li>
<li class="li"><a class="xref" href="#topic_wp2_jw5_wgc">Reverting a deployment</a></li>
<li class="li"><a class="xref" href="#topic_cjj_ty5_wgc">Renaming a deployment</a></li>
<li class="li"><a class="xref" href="#topic_bvy_jw5_wgc">Redeploying a reverted deployment</a></li>
<li class="li"><a class="xref" href="#topic_dyz_sy5_wgc">Deleting a deployment</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_yr1_tg3_xgc">
<h2 class="title topictitle2" id="ariaid-title2">Viewing a deployment's details, source, or destination</h2>
<div class="body">
<p class="p">After you create a deployment, you can view it's details, the source snapshot, and
the destination environment.</p>
<div class="p">
<strong class="ph b">To view a deployment</strong><ol class="ol" id="topic_yr1_tg3_xgc__ol_qly_wg3_xgc">
<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_yr1_tg3_xgc__d8e565" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png"><strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Sandbox &gt;
Deployments</strong>.</span></li>
<li class="li">Find the deployment you want more information about, click the options menu
icon (<img class="image" id="topic_yr1_tg3_xgc__image_vxk_xg3_xgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/macros_edit_menu_icon_vertical.png">), and select one of the following:<ul class="ul" id="topic_yr1_tg3_xgc__ul_cyd_yg3_xgc">
<li class="li"><strong class="ph b">View</strong></li>
<li class="li"><strong class="ph b">View source</strong></li>
<li class="li"><strong class="ph b">View destination</strong></li>
</ul>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_wp2_jw5_wgc">
<h2 class="title topictitle2" id="ariaid-title3">Reverting a deployment</h2>
<div class="body">
<p class="p">If you need to roll back changes you deployed, you can revert the deployment.</p>
<div class="p">
<strong class="ph b">To revert a deployment</strong><ol class="ol" id="topic_wp2_jw5_wgc__ol_r5s_zb3_xgc">
<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_wp2_jw5_wgc__d8e565" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png"><strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Sandbox &gt;
Deployments</strong>.</span></li>
<li class="li">Find the deployment you want to revert, click the options menu icon (<img class="image" id="topic_wp2_jw5_wgc__image_wjz_4g3_xgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/macros_edit_menu_icon_vertical.png">), and select <strong class="ph b">Revert</strong>.<p class="p">This creates a
new deployment with the source and destination environments
pre-selected. It's also automatically named <em class="ph i">Revert: [deployment
name]</em>, where <em class="ph i">[deployment name]</em> is replaced with the name
of the deployment you're reverting.</p>
</li>
<li class="li">Review the changes that would be made to the production environment. </li>
<li class="li">(Optional) Click <strong class="ph b">Refresh</strong> under the <em class="ph i">Destination</em> to ensure the
latest updates in the destination environment are reflected in the
comparison.</li>
<li class="li">Click <strong class="ph b">Test deploy</strong>.<p class="p">This can take up to several minutes. When the
test is complete, you will either see that it passed or be notified of
missing dependencies. </p>
<ul class="ul" id="topic_wp2_jw5_wgc__ul_rly_zhn_dgc">
<li class="li">If the test fails with missing dependencies, click <strong class="ph b">Auto-select
dependencies</strong>.</li>
<li class="li">Alternatively, you can click <strong class="ph b">Cancel</strong> to manually resolve the
dependency issue or click <strong class="ph b">Ignore</strong> to proceed without resolving
the missing dependency.</li>
</ul>
<div class="note note">
<span class="notetitle">Note:</span> After the test passes, no changes can be made to the
configurations selected in the deployment.</div>
</li>
<li class="li">Click <strong class="ph b">Deploy</strong>.<p class="p">When a deployment begins, Zendesk saves a version of
the destination environment before making any changes. This ensures you
can revert a deploy if necessary.</p>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_cjj_ty5_wgc">
<h2 class="title topictitle2" id="ariaid-title4">Renaming a deployment</h2>
<div class="body">
<p class="p">Sometimes it's necessary to rename a deployment.</p>
<div class="p">
<strong class="ph b">To rename a deployment</strong><ol class="ol" id="topic_cjj_ty5_wgc__ol_qrz_tf3_xgc">
<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_cjj_ty5_wgc__d8e565" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png"><strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Sandbox &gt;
Deployments</strong>.</span></li>
<li class="li">Find the deployment you want to rename, click the options menu icon (<img class="image" id="topic_cjj_ty5_wgc__image_czs_4g3_xgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/macros_edit_menu_icon_vertical.png">), and select <strong class="ph b">Rename</strong>.</li>
<li class="li">In the Rename deployment dialog, enter a new <strong class="ph b">Name</strong>.</li>
<li class="li">Click <strong class="ph b">Rename</strong>.</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested1" id="topic_bvy_jw5_wgc">
<h2 class="title topictitle2" id="ariaid-title5">Redeploying a reverted deployment</h2>
<div class="body">
<p class="p">There are times when you need to revert and then redeploy a deployment.</p>
<div class="p">
<strong class="ph b">To redeploy a deployment</strong><ol class="ol" id="topic_bvy_jw5_wgc__ol_y15_cg3_xgc">
<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_bvy_jw5_wgc__d8e565" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png"><strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Sandbox &gt;
Deployments</strong>.</span></li>
<li class="li">Find the deployment you want to redeploy, click the options menu icon
(<img class="image" id="topic_bvy_jw5_wgc__image_ib4_4g3_xgc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/macros_edit_menu_icon_vertical.png">), and select <strong class="ph b">Redeploy</strong>.<p class="p">This creates a
new deployment with the source and destination environments
pre-selected. It's also automatically named <em class="ph i">Redeploy: [deployment
name]</em>, where <em class="ph i">[deployment name]</em> is replaced with the name
of the deployment you're redeploying.</p>
</li>
<li class="li">Review the changes that would be made to the production environment. </li>
<li class="li">(Optional) Click <strong class="ph b">Refresh</strong> under the <em class="ph i">Destination</em> to ensure the
latest updates in the destination environment are reflected in the
comparison.</li>
<li class="li">Click <strong class="ph b">Test deploy</strong>.<p class="p">This can take up to several minutes. When the
test is complete, you will either see that it passed or be notified of
missing dependencies. </p>
<ul class="ul" id="topic_bvy_jw5_wgc__ul_z15_cg3_xgc">
<li class="li">If the test fails with missing dependencies, click <strong class="ph b">Auto-select
dependencies</strong>.</li>
<li class="li">Alternatively, you can click <strong class="ph b">Cancel</strong> to manually resolve the
dependency issue or click <strong class="ph b">Ignore</strong> to proceed without resolving
the missing dependency.</li>
</ul>
<div class="note note">
<span class="notetitle">Note:</span> After the test passes, no changes can be made to the
configurations selected in the deployment.</div>
</li>
<li class="li">Click <strong class="ph b">Deploy</strong>.<p class="p">When a deployment begins, Zendesk saves a version of
the destination environment before making any changes. This ensures you
can revert a deploy if necessary.</p>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested1" id="topic_dyz_sy5_wgc">
<h2 class="title topictitle2" id="ariaid-title6">Deleting a deployment</h2>
<div class="body">
<p class="p">Deleting a deployment is permanent and affects only the record of the deployment. The
changes that were deployed are unaffected. For Enterprise plans and above,
deployment events are also recorded in the audit log and will be preserved even if a
deployment is deleted from the Deployments page.</p>
<div class="p">
<strong class="ph b">To delete a deployment</strong><ol class="ol" id="topic_dyz_sy5_wgc__ol_fng_lg3_xgc">
<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_dyz_sy5_wgc__d8e565" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_account_icon.png"><strong class="ph b">Account</strong> in the sidebar, then select <strong class="ph b">Sandbox &gt;
Deployments</strong>.</span></li>
<li class="li">Find the deployment you want to delete, click the options menu icon (<img class="image" id="topic_dyz_sy5_wgc__image_gtc_kpl_yfc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/macros_edit_menu_icon_vertical.png">), and select <strong class="ph b">Delete</strong>.</li>
<li class="li">In the confirmation dialog, click <strong class="ph b">Delete deployment</strong>.</li>
</ol>
</div>
</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/9805528582298",
"url": "https://support.zendesk.com/hc/en-us/articles/9805528582298",
"headline": "Managing configuration deployments between Zendesk environments",
"description": "You can manage configuration deployments between environments by viewing, reverting, renaming, redeploying, or deleting deployments through the Admin Center interface.",
"articleSection": "Account administration",
"datePublished": "2025-10-08T16:21:50+00:00",
"dateModified": "2026-04-17T21:57:44.367372+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/9805528582298"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script><script id="fast-path-script">
//<![CDATA[
const fast_path_style = document.createElement('style');
fast_path_style.innerHTML = `#article-body .fastpath{font-size:.9em;background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 8px;margin-bottom:16px}#article-body .fastpath::before{content:none!important}`;
document.head.appendChild(fast_path_style);
//]]>
</script>
</body>