Adding multiple article, section, and category templates to your theme

<body>
<p id="docs-hc-snippet" style="display: none;">A help center theme has one page template for articles, one for sections, and one for categories by default. You can create up to 100 additional page templates each for articles, sections, and categories.</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 create multiple article, section, and category templates to give content different layouts and apply the right page template to new or existing pages. Admins can build and preview up to 100 templates per type in the theme editor or in downloaded themes, helping you customize the knowledge base design for different content needs.</p>
</div>

<div class="body">

<div class="p">
<div class="note">
<span class="notetitle">Note:</span> On Suite Growth and Professional or on Support with Knowledge Professional, you can
access this feature and create multiple templates in a <em class="ph i">non-live theme</em> to try it out.
You cannot create multiple templates in your live theme.</div>
</div>
<p class="p">A help center theme has one page template for articles, one for sections, and one for categories by
default. You can create up to 100 additional page templates each for articles, sections, and
categories. </p>
<p class="p">This means that you can create alternate versions of templates to use for your articles,
sections, and categories. You can change the look and feel based on content. You can apply or
change the page template when you create or edit an article, section, or category.</p>
<p class="p">You cannot create additional templates for any other page type in your theme. You must be a
Knowledge admin to create multiple templates. </p>
<p class="p">When you create additional custom templates for a theme, you can only select those templates
if the theme you created them for is live. In other words, the theme must be active before you
can select the custom templates associated with that theme.</p>
<div class="p">
<div class="note" id="topic_q1r_v3f_bfb__note_bpl_pdn_1tb">
<span class="notetitle">Note:</span> Page templates are different from Knowledge templates that you
create for Knowledge. See <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408828223898" target="_blank">Creating templates for Knowledge</a>.</div>
</div>
<div class="p">This article contains the following sections:<ul class="ul" id="topic_q1r_v3f_bfb__ul_nqg_mf4_bfb">
<li class="li"><a class="xref" href="#topic_v2b_bkf_bfb">Adding multiple templates using the theme editor</a></li>
<li class="li"><a class="xref" href="#topic_igz_bkf_bfb">Adding multiple templates in downloaded themes</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_v2b_bkf_bfb">
<h2 class="title topictitle2" id="ariaid-title2">Adding multiple templates using the theme editor</h2>
<div class="body">
<div class="p">You can create additional page templates for articles, sections, and categories using the
theme editor. If you prefer working on your themes locally, you can also add templates to
your <a class="xref" href="#topic_igz_bkf_bfb">downloaded themes</a>.<div class="note" id="topic_v2b_bkf_bfb__note_bvs_b1s_b1c">
<span class="notetitle">Note:</span> Help center themes do not support template partials, which are
smaller, reusable templates that can be imported into a parent template.</div>
</div>
<div class="p">
<strong class="ph b">To add an article, section, or category template using the theme editor</strong><ol class="ol" id="topic_v2b_bkf_bfb__ol_w44_dkf_bfb">
<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">Customize design</strong>
(<img class="image" id="topic_v2b_bkf_bfb__image_hzf_jfx_s2c" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/guide_icon_customize.png">) in the sidebar.</span><p class="p">Your themes appear on the <strong class="ph b">Themes</strong> page.</p>
</li>
<li class="li">On the theme you want to edit, click <strong class="ph b">Customize</strong>.</li>
<li class="li">Click <strong class="ph b">Edit code</strong>. <p class="p"><img class="image img-screenshot" id="topic_v2b_bkf_bfb__image_y44_dkf_bfb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/theming_menu_option_edit_code.png" width="600"></p>
</li>
<li class="li">In the Files area, click <strong class="ph b">Add new</strong>, then select the template that you want to
add.<p class="p"><img class="image img-screenshot" id="topic_v2b_bkf_bfb__image_q35_n1s_nrb" src="https://zen-marketing-documentation.s3.us-west-1.amazonaws.com/docs/en/add_new_template_dropdown.png" width="250"></p>
</li>
<li class="li">Under <strong class="ph b">Template for</strong>, select the type of template you'd like to create.<p class="p">You can
create article, section, and category templates only. You can create up 100 additional
templates for each type.</p>
<p class="p"><img class="image img-screenshot" id="topic_v2b_bkf_bfb__image_bjj_nj4_bfb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/add_new_template_select_type.png" width="400"></p>
</li>
<li class="li">Enter a <strong class="ph b">Template name</strong>.</li>
<li class="li">Under <strong class="ph b">Start from</strong>, select an existing template to copy and use as a starting
point.<p class="p">You can select blank template if you don't want to start from another
template.</p>
</li>
<li class="li">Click <strong class="ph b">Create template</strong>.<p class="p">The new template opens for you.</p>
</li>
<li class="li">Edit your template and click <strong class="ph b">Save</strong> as you go.</li>
<li class="li">To preview your template, click <strong class="ph b">Preview</strong>, then click <strong class="ph b">Templates</strong> at the top
of the preview and select the template you want to preview.<p class="p"><img class="image img-screenshot" id="topic_v2b_bkf_bfb__image_uh2_dsk_cfb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/add_template_preview_select_template.png" width="250"></p>
<p class="p">For more information, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845893274#topic_nsr_qgc_ccb" target="_blank">Previewing your theme while editing theme
code</a>.</p>
</li>
</ol>
</div>
<p class="p">When you are ready, you can apply your template to a <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408839258778" target="_blank">new article</a> or <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845897370" target="_blank">new category or section</a>. You can also change the template on an
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408828826650" target="_blank">existing article, section, or category</a>.</p>
</div>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested1" id="topic_igz_bkf_bfb">
<h2 class="title topictitle2" id="ariaid-title3">Adding multiple templates in downloaded themes</h2>
<div class="body">
<p class="p">If you download and work on themes locally, you can add multiple templates to the themes.
The workflow consists of creating a predefined folder in a theme's <strong class="ph b">templates</strong> folder,
then adding <strong class="ph b">.hbs</strong> template files to the folder. </p>
<p class="p">To learn more about working on themes locally, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408838187802-Working-on-a-theme-locally-Guide-Professional-and-Enterprise-" target="_blank">Working on a theme locally</a>.</p>
<p class="p"><strong class="ph b">To add a template to an downloaded theme</strong></p>
<ol class="ol" id="topic_igz_bkf_bfb__ol_jwj_xwp_cfb">
<li class="li">Depending on the type of template you want to add (article, section, or category),
create any of the following folders in the <strong class="ph b">templates</strong> folder of the downloaded
theme:<ul class="ul" id="topic_igz_bkf_bfb__ul_lb1_yxp_cfb">
<li class="li"><strong class="ph b">article_pages</strong></li>
<li class="li"><strong class="ph b">section_pages</strong></li>
<li class="li"><strong class="ph b">category_pages</strong></li>
</ul>
<p class="p">As in the theme editor, you can only create article, section, and category
templates.</p>
</li>
<li class="li">Add an <strong class="ph b">.hbs</strong> template file in the new folder. <p class="p">You can name the file anything
you want. The name must be 25 characters or less, and snake_case.</p>
<img class="image img-screenshot" id="topic_igz_bkf_bfb__image_p5y_l2q_cfb" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/article_pages_folder.png" width="220"><div class="note tip">
<span class="tiptitle">Tip:</span> To save time, copy an existing
<strong class="ph b">.hbs</strong> file into the folder to use as a starting point for the new template.
</div>
</li>
<li class="li">Edit and save the template.</li>
<li class="li">If you need to add more templates of the same type, add them to the same folder.</li>
<li class="li">When you're done, zip the theme and <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408828976538-Importing-and-exporting-your-theme-and-manifest-file-Guide-Professional-and-Enterprise-" target="_blank">import it</a> into Knowledge admin. </li>
</ol>
<p class="p">Use Knowledge admin to <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845893274#topic_nsr_qgc_ccb" target="_blank">preview the new template</a>.</p>
<div class="p">When you are ready, you can apply your template to a <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408839258778" target="_blank">new article</a> or <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408845897370" target="_blank">new category or section</a>. You can also change the template on an
<a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408828826650" target="_blank">existing article, section, or category</a>.<div class="note">
<span class="notetitle">Note:</span> You can create up to
100 page templates per article, section, and category.</div>
</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/4408828878106",
"url": "https://support.zendesk.com/hc/en-us/articles/4408828878106",
"headline": "Adding multiple article, section, and category templates to your theme",
"description": "You can add up to 100 article, section, or category templates to a theme, then create, edit, preview, and apply them in the theme editor or in downloaded theme files.",
"articleSection": "Using themes and customizing your help center",
"datePublished": "2021-10-16T03:33:32+00:00",
"dateModified": "2026-09-01T19:27:07.612649+00:00",
"inLanguage": "en",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/4408828878106"
},
"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>