Editing content blocks

<body>
<p id="docs-hc-snippet" style="display: none;">After youcreate or insert a content block, you can edit the content block as needed. You must be a Knowledge admin or anagent with permission to update content blocksto edit and update content blocks.</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_ee">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Enterprise or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>

<div class="article-banner" id="support_with_guide_e">
<table>
<tbody>
<tr>
<td>
<strong>Support with</strong>
</td>
<td>Knowledge 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 edit content blocks to update reusable help content across all articles that use them without republishing those articles. Knowledge admins and authorized agents can change the block from the content block list or from within an article, and you can also edit HTML source for supported code. Changes appear in published articles right away, making content block management and shared content updates easier.</p>
</div>

<div class="body">

<p class="p">After you <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408832857754" target="_blank">create or insert a content block</a>, you can edit the content block as
needed. You must be a Knowledge admin or an <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4823057157146" target="_blank">agent with permission to update content blocks</a> to edit and update
content blocks. </p>
<p class="p">When you update a content block, it is automatically updated in the articles in which it is
used without impacting the article status. You can access the content block editor from the
content block list or from any article using a content block. When you edit and update
a content block, all articles containing that content block are automatically updated in
your help center to include the new content without impacting the articles' publication
status.</p>
<div class="p">This article covers the following topics:<ul class="ul" id="topic-1__ul_hhd_jvx_wwb">
<li class="li"><a class="xref" href="#topic_bbr_k1p_ywb">About editing HTML source code in content
blocks</a></li>
<li class="li"><a class="xref" href="#topic_hvg_kvx_wwb">Editing a content block from the content
block list</a></li>
<li class="li"><a class="xref" href="#topic_e1s_rvx_wwb">Editing a content block from within an
article</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_bbr_k1p_ywb">
<h2 class="title topictitle2" id="ariaid-title2">About editing HTML source code in content blocks</h2>
<div class="body">
<p class="p">If you are a Knowledge admin or an <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4823057157146" target="_blank">agent with permissions to update content blocks</a>, you can use the
content block editor to make changes to the content block and update all articles in which
the content block appears. You can also edit the block's HTML source by clicking the
<strong class="ph b">Source Code</strong> (<img class="image" id="topic_bbr_k1p_ywb__image_iqc_xwk_bcc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-art-editor-html-ico.png" width="30">) icon at the end of the editor's toolbar.</p>
<div class="p">If you are editing the content block HTML source, be aware that the content block editor
removes <code class="ph codeph">class</code> and <code class="ph codeph">id</code> attributes from the HTML source of
content blocks, with the following exceptions:<ul class="ul" id="topic_bbr_k1p_ywb__ul_w5z_r5x_wwb">
<li class="li">Top-level <code class="ph codeph">div</code> tags can use the <code class="ph codeph">class</code> attribute.</li>
<li class="li">Heading tags, such as <code class="ph codeph">h1</code> and <code class="ph codeph">h2</code>, can use the
<code class="ph codeph">id</code> attribute. If you don't specify an <code class="ph codeph">id</code>, Zendesk
automatically assigns one to headings. Content blocks don't support <code class="ph codeph">h5</code>
or <code class="ph codeph">h6</code> headings.</li>
</ul>
</div>
<p class="p">If you are working with unsupported code, you can use <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/6739380623770" target="_blank">HTML blocks</a> to quickly access and edit complex HTML code in your
content blocks. HTML blocks let you work with blocks of code that would otherwise not be
editable within the content block editor, and to display them in a safe manner within your
help center.</p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_hvg_kvx_wwb">
<h2 class="title topictitle2" id="ariaid-title3">Editing a content block from the content block list</h2>
<div class="body">
<p class="p">Knowledge admins can edit a content block from the central content block management list. When
you edit content blocks from the content blocks list, you are editing the master version of
a content block that doesn’t have any context of the articles in which it is used. </p>
<p class="p">When you update the content block, your changes automatically appear in all published
articles that contain it. To make sure you understand which articles will be
automatically updated when you update a content block from this list, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5519935879066" target="_blank"> view the articles that contain the content block</a>.</p>
<div class="p">
<strong class="ph b">To edit a content block from the content block list</strong><ol class="ol" id="topic_hvg_kvx_wwb__ol_jxz_r3d_xtb">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9041943683354#topic_b5q_nwn_s2c" target="_blank">Knowledge admin</a>, click <strong class="ph b">Manage articles</strong>
(<img class="image" id="topic_hvg_kvx_wwb__d8e24" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide_icon_manage_articles.png">) in the sidebar.</span></li>
<li class="li">Under the <strong class="ph b">Content objects</strong> tab in the left menu, click <strong class="ph b">Content
blocks</strong>.</li>
<li class="li">Click a content block to open the content block editor. </li>
<li class="li">Use the content block editor to make any necessary changes. </li>
<li class="li">Click <strong class="ph b">Update</strong>. Your updates are saved and visible in all articles that use the
content block. You do not need to republish the articles for the changes to appear.</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_e1s_rvx_wwb">
<h2 class="title topictitle2" id="ariaid-title4">Editing a content block from within an article</h2>
<div class="body">
<p class="p">Knowledge admins and <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4823057157146" target="_blank">agents with permission to update content blocks</a> can edit and
update content blocks. You can update a content block from within the article that contains
it. When editing a content block from within an article, the article remains open in the
background. To return to the article without saving the content block, click the breadcrumb
in the upper left corner of the window.</p>
<p class="p"><strong class="ph b">To edit a content block from within an article that is using it</strong></p>
<div class="p">
<ol class="ol" id="topic_e1s_rvx_wwb__ol_ivq_nby_vjb">
<li class="li">Open the article that contains the content block you want to edit in <strong class="ph b">Edit</strong>
mode.</li>
<li class="li">Click the content block you want to edit, then select the <strong class="ph b">Edit</strong> icon (<img class="image" height="16" id="topic_e1s_rvx_wwb__image_i44_gmx_gqb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/knw-0726-contentblock-editico.png" width="16">).<p class="p"><img alt="Knowledge content blocks menu" class="image img-screenshot" id="topic_e1s_rvx_wwb__image_rhq_qbt_mpb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/knw-0726-contentblock-edittools.png" width="700"></p>
</li>
<li class="li">Make any necessary changes in the content block editor. </li>
<li class="li">Click <strong class="ph b">Update</strong>.<p class="p">Your updates are saved and visible in all articles that use the
content block. You do not need to republish the articles for the changes to
appear.</p>
</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/5517016948762",
"url": "https://support.zendesk.com/hc/en-us/articles/5517016948762",
"headline": "Editing content blocks",
"description": "You can edit a content block from the list or within an article, and updates are applied to every article that uses it without republishing.",
"articleSection": "Working with articles in the knowledge base",
"datePublished": "2023-03-22T15:13:46+00:00",
"dateModified": "2026-07-15T19:55:17.448504+00:00",
"inLanguage": "en",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/5517016948762"
},
"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><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>