Transitioning to the new article editor

<body>
<p id="docs-hc-snippet" style="display: none;">With the new article editor, you have access to enhanced editing tools, source code improvements, and advanced article components, such as HTML blocks, summaries, and more. In addition, you can take advantage of newly released features, such asAI article translation, that are only available with the new article editor. For more information seeEditing articles in the knowledge base.</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_with_guide_all">
<table>
<tbody>
<tr>
<td>
<strong>Support with</strong>
</td>
<td>Knowledge Professional or Enterprise</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="body">
<div class="p">
<div class="note" id="topic_uqr_clr_w1c__note_qtf_5hp_zgc">
<span class="notetitle">Note:</span> The transition from the legacy article editor to the new
article editor will be complete on April 22, 2026. After this date, the legacy
editor will no longer be available. See the <a class="xref" href="#topic_f54_tby_qgc">transition timeline</a> below for more information.</div>
In
May 2025, Zendesk introduced a new, enhanced article editor that provides an intuitive
and enriched content creation experience, designed to streamline content creation and
boost audience engagement. This updated article editor has a phased transition period
for new and existing articles, and provides an option for you to continue using the
legacy editor until the end of the transition.</div>
<p class="p">With the new article editor, you have access to enhanced editing tools, source code
improvements, and advanced article components, such as HTML blocks, summaries, and more.
In addition, you can take advantage of newly released features, such as <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/8717609637018" target="_blank">AI article translation</a>, that are only available with the new
article editor. For more information see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9185667124506" target="_blank">Editing articles in the knowledge base</a>.</p>
<p class="p">To ease your transition to the new article editor, it's important to understand the
transition timeline, reason for the transition, and how to troubleshoot issues you may
encounter. </p>
<div class="p">This article includes the following topics:<ul class="ul" id="topic_uqr_clr_w1c__ul_e3l_bmr_w1c">
<li class="li"><a class="xref" href="#topic_kh1_qjx_qgc">Comparing the legacy editor and new editor frameworks</a></li>
<li class="li"><a class="xref" href="#topic_f54_tby_qgc">Understanding the timeline for transitioning to the new article editor</a></li>
<li class="li"><a class="xref" href="#topic_uht_j2z_mhc">What to expect after the transition ends</a></li>
<li class="li"><a class="xref" href="#topic_ass_sgp_jfc">Troubleshooting issues when transitioning to the new article editor</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_kh1_qjx_qgc">
<h2 class="title topictitle2" id="ariaid-title2">Comparing the legacy editor and new editor frameworks</h2>
<div class="body">
<p class="p">The legacy editor was built using an HTML approach, which worked much like an
enhanced text box in your browser. Whenever you formatted text, these actions
directly manipulated the content as HTML. Behind the scenes, typing or formatting
was translated into messy (or sometimes inconsistent) markup, heavily influenced by
your browser and whatever content was pasted in the editor.</p>
<p class="p">The new editor takes a structured data model approach. This means that it translates
content into a structured data model, where each piece of content is an object with
defined properties, attributes and relationships. This model separates content from
data attributes, which is what provides the new editor with so much of its
flexibility, security, and ability to integrate with advanced features and tools. </p>
<p class="p">As with any migration to a more advanced platform, there are transition issues and
workflow modifications that must be addressed and resolved. Because the legacy
editor was built on HTML instead of the more powerful objects, you could customize
and add any HTML you wanted in the article editor. As you transition your articles
to the new editor, you may find that some of this code is no longer supported, and
as a result, your content is wrapped in an HTML block for its protection. Or, you
may find that you now are working with tables, images, or other article editing
elements in a different way. </p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_f54_tby_qgc">
<h2 class="title topictitle2" id="ariaid-title3">Understanding the timeline for transitioning to the new article editor</h2>
<div class="body">
<p class="p">The transition from the legacy article editor to the new article editor has four
phases, from May 22, 2025 through April 22, 2026. Throughout the phased transition,
new and existing articles will gradually move from the legacy editor to the new
article editor. </p>
<p class="p">Once an article has been migrated to the new article editor, it will no longer open
or be editable in the legacy editor. This applies to <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408829321498" target="_blank">restoring previous versions</a> as well. When you restore a
previous version of an article that was created in the legacy article editor, the
article will still open in the new article editor. You can't restore the legacy
article editor, even if the article you're restoring was edited and published using
the legacy editor. </p>
<p class="p">Refer to the following table for a summary of the transition information shown in the
diagram above.</p>
<div class="p" id="topic_f54_tby_qgc__p_ofn_p3p_zgc">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_f54_tby_qgc__table_i41_q3p_zgc" rules="all" summary="">
<colgroup>
<col style="width:33.33333333333333%">
<col style="width:33.33333333333333%">
<col style="width:33.33333333333333%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry cellrowborder" id="d87e129" rowspan="2" style="vertical-align:top;">Period</th>
<th class="entry cellrowborder" colspan="2" id="d87e132" style="vertical-align:top;">Article type</th>
</tr>
<tr class="row">
<th class="entry cellrowborder" id="d87e138" style="vertical-align:top;">Existing articles</th>
<th class="entry cellrowborder" id="d87e141" style="vertical-align:top;">New articles</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry cellrowborder" headers="d87e129" style="vertical-align:top;">
<strong class="ph b">New Editor GA</strong><p class="p">Q2 2025</p>
</td>
<td class="entry cellrowborder" headers="d87e132 d87e138" style="vertical-align:top;">Open in the legacy editor.<p class="p">You can save in the new editor
and switch back as needed.</p>
</td>
<td class="entry cellrowborder" headers="d87e132 d87e141" style="vertical-align:top;">Open in the new editor.<p class="p">You can revert to the legacy editor
if needed.</p>
</td>
</tr>
<tr class="row">
<td class="entry cellrowborder" headers="d87e129" style="vertical-align:top;">
<strong class="ph b">Transitionary period</strong><p class="p">Nov 3, 2025 - Jan 11,
2026</p>
</td>
<td class="entry cellrowborder" colspan="2" headers="d87e132 d87e138 d87e141" style="vertical-align:top;">Open in the new editor.<p class="p">You can
switch between the new and legacy editors until you click
Save and migrate. After migrating, the article only opens in
the new editor.</p>
</td>
</tr>
<tr class="row">
<td class="entry cellrowborder" headers="d87e129" style="vertical-align:top;">
<strong class="ph b">New articles - New editor only</strong><p class="p">Jan 11, 2026 - Mar
31, 2026</p>
</td>
<td class="entry cellrowborder" headers="d87e132 d87e138" style="vertical-align:top;">Open in the new editor. <p class="p">You can switch between the new and
legacy editors until you click Save and migrate. After
migrating, only the new editor is available.</p>
</td>
<td class="entry cellrowborder" headers="d87e132 d87e141" style="vertical-align:top;">Open in the new editor without the option to revert to the
legacy editor.</td>
</tr>
<tr class="row">
<td class="entry cellrowborder" headers="d87e129" style="vertical-align:top;">
<strong class="ph b">Legacy editor sunset Q2 2026</strong><p class="p">Transition complete
April 22, 2026</p>
</td>
<td class="entry cellrowborder" colspan="2" headers="d87e132 d87e138 d87e141" style="vertical-align:top;">Open in the new editor without the
option to revert to the legacy editor.</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_uht_j2z_mhc">
<h2 class="title topictitle2" id="ariaid-title4">What to expect after the transition ends</h2>
<div class="body">
<p class="p">The transition to the new article editor will be complete on April 22, 2026. After
this date, you'll still have access to all of your articles in the new editor
without an option to revert to the legacy editor. All references to the legacy
editor will be removed, and the new article editor will be the only available
article editor. </p>
<p class="p">If you haven't migrated your existing articles to the new editor by the end of the
transition, you'll still have access to those articles but will only be able to
view and edit them in the new article editor. </p>
<p class="p">Because HTML blocks protect custom code incompatibilities between the legacy and new
editor, your articles should appear correctly when published. However, custom code
that is incompatible with the new editor will be wrapped in an HTML block to protect
the code. To learn more about how to work with HTML blocks in the new editor, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/6739380623770" target="_blank">Using HTML blocks to edit code in content blocks</a> and
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9957160094106" target="_blank">Troubleshooting issues with HTML blocks in the
new article editor</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested1" id="topic_ass_sgp_jfc">
<h2 class="title topictitle2" id="ariaid-title5">Troubleshooting issues when transitioning to the new article editor</h2>
<div class="body">
<div class="p">If you experience issues with your help center content that is moved from the legacy
editor to the new article editor, refer to the following <a class="xref" href="https://support.zendesk.com/hc/en-us/categories/6191861453978" target="_blank">Help and FAQs</a> articles:<ul class="ul" id="topic_ass_sgp_jfc__ul_opg_qcy_jfc">
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9940765676570" target="_blank">Troubleshooting formatting issues in the
new article editor</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9941302585242" target="_blank">Troubleshooting issues with links in the
new article editor</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9936959655834" target="_blank">Troubleshooting issues with tables in the
new article editor</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9957160094106" target="_blank">Troubleshooting issues with HTML blocks
in the new article editor</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9945319548954" target="_blank">Troubleshooting issues with images and
videos in the new article editor</a></li>
</ul>
</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/7595840358042",
"url": "https://support.zendesk.com/hc/en-us/articles/7595840358042",
"headline": "Transitioning to the new article editor",
"description": "You will transition from the legacy article editor to a new structured data model editor by April 22, 2026, which offers enhanced editing tools and features while phasing out the legacy editor's HTML-based framework.",
"articleSection": "Working with articles in the knowledge base",
"datePublished": "2024-07-12T13:10:04+00:00",
"dateModified": "2026-04-08T19:14:41.159806+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/7595840358042"
},
"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",
"softwareAddOn": {
"@type": "SoftwareApplication",
"name": "Knowledge",
"@id": "https://support.zendesk.com/hc/en-us/sections/4405298860954"
}
}
}</script>
</body>