Creating and inserting reusable information with content blocks

<body>
<p id="docs-hc-snippet" style="display: none;">Content blocks are segments of text that are grouped and reused across one or more articles in your help center or across different help center brands in your account. You can create a content block from your help center or from within an article where you want to use the content block. In both cases, the content block appears in the content block list, where you canview the content blockand where it is used,edit the content block, orremove the content block from your help center.</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">Content blocks let you reuse text, tables, lists, code, and media across articles and help center brands. You can create them from the help center or from an article, then insert them where needed and update them in one place. They help you keep reusable content consistent, save time, and manage localized content for admins and agents with edit permission.</p>
</div>

<div class="body">

<p class="p">Content blocks are segments of text that are grouped and reused across one or more articles
in your help center or across different help center brands in your account. You can create a
content block from your help center or from within an article where you want to use the
content block. In both cases, the content block appears in the content block list, where you
can <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5519935879066" target="_blank">view the content block</a> and where it is used, <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5517016948762" target="_blank">edit the content block</a>, or <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5519936040986" target="_blank">remove the content block from your help center</a>. </p>
<p class="p">Knowledge admins can create and insert content blocks on any article. Agents can only create and
insert content blocks in articles that they have permission to edit. Knowledge admins or agents
with <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4823057157146" target="_blank">permission to update</a> content blocks can edit and update content
blocks in published articles that include those blocks.</p>
<div class="p">This article covers the following topics:<ul class="ul" id="topic-1__ul_yn1_3n3_z3b">
<li class="li"><a class="xref" href="#topic_thc_2ph_k5b">Creating a content block from the help
center</a></li>
<li class="li"><a class="xref" href="#topic_bkb_myf_gjb">Creating a content block from an
article</a></li>
<li class="li"><a class="xref" href="#topic_psl_kyf_gjb">Inserting a content block into an article</a></li>
</ul>
</div>
<div class="p">Related articles:<ul class="ul" id="topic-1__ul_l2d_vjq_mdc">
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5519935879066" target="_blank">Viewing the content blocks list</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5517016948762" target="_blank">Editing content blocks</a></li>
<li class="li"><a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5519936040986" target="_blank">Removing content blocks from articles and your help center</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_thc_2ph_k5b">
<h2 class="title topictitle2" id="ariaid-title2">Creating a content block from the help center</h2>
<div class="body">
<p class="p">When you create a content block from the help center menu, the content block is added to
the content blocks list and is available to insert into any article where you want it to
appear. See <a class="xref" href="#topic_psl_kyf_gjb">Inserting a content block into an article</a>. </p>
<p class="p">Content blocks created from the help center take on the default locale of the help center,
regardless of the language used within the content block itself. For example, if you create
content blocks from a help center where the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408827609882-Configuring-your-help-center-to-support-multiple-languages" target="_blank"><u class="ph u">default language</u></a> is American English, the
content block locale will also be English, even if the body of the content block contains
Spanish text.</p>
<p class="p"><strong class="ph b">To create a content block from the help center</strong></p>
<div class="p">
<ol class="ol" id="topic_thc_2ph_k5b__ol_uhc_2ph_k5b">
<li class="li">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/9041943683354#topic_dzz_4wn_s2c" target="_blank">help center</a> or <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">Add</strong> in the top
menu bar, then select <strong class="ph b">Content block</strong>.<p class="p"><img class="image img-screenshot" id="topic_thc_2ph_k5b__image_a5n_qqh_k5b" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/knw-0726-contentblock-addarticle.png" width="175"></p>
</li>
<li class="li">Give the content block a meaningful name, so you can easily identify it when you reuse
it in other articles. This is an internal name that identifies your content block on the
content blocks list. It is not visible to end users.<p class="p"><img alt="Create content block" class="image img-screenshot" id="topic_thc_2ph_k5b__image_yhc_2ph_k5b" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-create-cb-notb.png" width="600"></p>
</li>
<li class="li">Use the toolbar and autoformatting options to format the content within the content
block as needed, for example, adding bold, creating a bulleted list or table, or
inserting a link or media (such as video). See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408839186586-Help-Center-article-editor-toolbar-reference" target="_blank">Help center article editor
reference</a>.<p class="p">Formatting the content in a content block affects all articles
that use this content block.</p>
</li>
<li class="li">Click <strong class="ph b">Create</strong>.<p class="p">The content is now a content block and is stored independently
for reuse by other articles. You can <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/5517016948762" target="_blank">edit the content block</a> or return to the content block list
to perform other management tasks. </p>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_bkb_myf_gjb">
<h2 class="title topictitle2" id="ariaid-title3">Creating a content block from an article</h2>
<div class="body">
<p class="p">You can create a content block from a single unit of content, such as a paragraph, section
heading, table, code block, or bulleted list. You can also create a content block from
multiple (consecutive) sections of content in an article, or even from the text of an entire
article. You can use <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408831783962#topic_vky_znm_mpb" target="_blank">one or many content blocks within an article</a>,
alongside regular text. In this section <em class="ph i">regular text</em> refers to any article text that
you create that is not in a content block.</p>
<p class="p">Content blocks created from an article assume the article’s locale, regardless of the
language used within the content block itself. For example, if you create a content block
from a Spanish article, the content block’s locale will also be Spanish, even if the content
of the block contains English text.</p>
<p class="p"><strong class="ph b">To create a content block</strong></p>
<div class="p">
<ol class="ol" id="topic_bkb_myf_gjb__ol_ivq_nby_vjb">
<li class="li">If you have not done so already, save the article in which you want to create a
content block.</li>
<li class="li">In your article, select the content you want to make into a reusable content
block.<div class="note">
<span class="notetitle">Note:</span> If you select a fragment of text, for example, one sentence within a
paragraph, the whole paragraph will be included in the new content block. A paragraph
or section heading is the smallest fragment of content that you can include in a
content block.</div>
</li>
<li class="li">On the top toolbar, click the <strong class="ph b">insert content block</strong> (<img class="image" id="topic_bkb_myf_gjb__image_hsm_tgx_kpb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/create_content_block_icon.png">) icon. <div class="note" id="topic_bkb_myf_gjb__note_v1v_sbv_4sb">
<span class="notetitle">Note:</span> When you are creating 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.</div>
</li>
<li class="li">Give the content block a meaningful name, so that you can easily identify it when you
reuse it in other articles.<p class="p"><img alt="create content block" class="image img-screenshot" id="topic_bkb_myf_gjb__image_hgr_srz_4pb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-create-cb-from-article.png" width="600"></p>
</li>
<li class="li">Use the toolbar and autoformatting options to format the content within the content
block as needed, for example, adding bold, creating a bulleted list or table, or
inserting a link or media (such as a video). See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408839186586-Help-Center-article-editor-toolbar-reference" target="_blank">Help center article editor
reference</a>.<p class="p">Formatting the content in a content block affects all articles
that use this content block.</p>
</li>
<li class="li">Click <strong class="ph b">Create</strong>.<p class="p">The content is now a content block and is stored independently
for reuse by other articles. In the article, the text appears with a shaded
background. You don't need to save the article to create a content block.</p>
</li>
</ol>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested1" id="topic_psl_kyf_gjb">
<h2 class="title topictitle2" id="ariaid-title4">Inserting a content block into an article</h2>
<div class="body">
<p class="p">You can insert a content block into any help center article where you want to include
reusable content. </p>
<p class="p"><strong class="ph b">To insert a content block into an article</strong></p>
<div class="p">
<ol class="ol" id="topic_psl_kyf_gjb__ol_zft_1gy_vjb">
<li class="li">In your article, click where you want to add reusable content.<div class="note" id="topic_psl_kyf_gjb__note_ab1_kjq_hcc">
<span class="notetitle">Note:</span> You can't insert content blocks into bulleted or numbered
lists.</div>
</li>
<li class="li">On the top toolbar, click the <strong class="ph b">content block</strong> (<img class="image" id="topic_psl_kyf_gjb__image_zdr_ygx_kpb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/create_content_block_icon.png">) icon. <p class="p">A list of available content blocks
appears.</p>
</li>
<li class="li">Choose the content block that you want to add.<div class="p">Refine your results by:<ul class="ul" id="topic_psl_kyf_gjb__ul_fbc_wgy_vjb">
<li class="li">Specifying part of the content block name. Only the content block name is
searched, not the content block body.</li>
<li class="li">Sorting by edited date or created date.</li>
<li class="li">Sorting alphabetically.</li>
</ul>
You can also specify the language of the content block, if localized versions are
available.</div>
</li>
<li class="li">Click a content block to preview the content. <p class="p"><img class="image img-screenshot" id="topic_psl_kyf_gjb__image_agt_1gy_vjb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/knw-0726-contentblock-insertcontblock.png" width="600"></p>
</li>
<li class="li">Click <strong class="ph b">Insert</strong>.<p class="p">The content block is inserted into the article and appears with
a shaded background.</p>
<p class="p">In the source code view (<img class="image" id="topic_psl_kyf_gjb__image_iqc_xwk_bcc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide-art-editor-html-ico.png" width="30">), you won't see any HTML code for content
blocks, only for your regular text. This is because content blocks live independently
in the help center. Additionally, you'll only see the HTML code for the chunk of
regular text where your cursor is placed, between content blocks. </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/4408832857754",
"url": "https://support.zendesk.com/hc/en-us/articles/4408832857754",
"headline": "Creating and inserting reusable information with content blocks",
"description": "You can create and insert reusable content blocks in articles, define them from the help center or an article, and update shared content used across articles.",
"articleSection": "Working with articles in the knowledge base",
"datePublished": "2021-10-16T03:47:45+00:00",
"dateModified": "2026-07-15T19:48:11.254087+00:00",
"inLanguage": "en",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408832857754"
},
"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>