Help center content is organized in a Home > Categories > Sections > Articles structure. By default, each section belongs to only one category, and each article is assigned to a single section. The article multiplacement feature, which allows articles to appear in multiple sections, is available exclusively to Enterprise plans.

Alternatively, you can display links to specific articles or sections on the page you'd like them to be available by customizing the template for that section or category. Use the is property in the code to display the content in an additional section or category.

To do this, you need the ID of the section or category. The section or category ID is at the end of their URL. For example, this article is published in the category: https://support.zendesk.com/hc/en-us/categories/4405298745754. The category ID is 4405298745754.

This article contains instructions for the following:

  • Adding an article to a section
  • Adding a section to a category
  • Adding an article to a category
  • Adding an article to an empty section
  • Adding a section to an empty category
Disclaimer: This article is provided for instructional purposes only. Zendesk doesn't support or guarantee the code. Post any issues in the comments section or search for a solution online.

Adding an article to a section

To add an article to a section:
  1. In Knowledge, select Knowledge admin
  2. Click the Customize design icon () in the sidebar
  3. From the theme you want to work with, click Customize
  4. Click Edit code
  5. In the template editor, under Files, open section_page.hbs
  6. Place the code below the <ul class= "article-list"> element, which belongs to the {{#if section.articles}} helper
    {{#is section.id ######}}
    <a href="article URL without the text slug">Title of the article</a>
    {{/is}}
    place article in section
  7. Click Publish

Adding a section to a category

To add a section to a category:
  1. In Knowledge, select Knowledge admin
  2. Click the Customize design icon () in the sidebar
  3. From the theme you want to work with, click Customize
  4. Click Edit code
  5. In the template editor, under Files, open category_page.hbs
  6. Place the code below the <div id="main-content" class="section-tree">.
    {{#is category.id ######}}
    <a href="section URL without the text slug">Title of the section</a>
    {{/is}}
    place section in category page
  7. Click Publish

Adding an article to a category

To add an article to the category page within the {{#each section}} helper:
  1. In Knowledge, select Knowledge admin
  2. Click the Customize design icon () in the sidebar
  3. From the theme you want to work with, click Customize
  4. Click Edit code
  5. In the template editor, under Files, open category_page.hbs
  6. Place the code below the {{#each sections}} helper
    {{#is id ######}}
    <a href="article URL without the text slug">Title of the article</a>
    {{/is}}
  7. Click Publish

Adding an article to an empty section

The workflow is different because the code incorporates the else /if statement that displays an empty link within the section.

To add an article to an empty section:

  1. In Knowledge, select Knowledge admin
  2. Click the Customize design icon () in the sidebar.
  3. From the theme you want to work with, click Customize
  4. Click Edit code
  5. In the template editor, under Files, open section_page.hbs
  6. Replace the code that goes from {{else}} to {{/if}} with the code below
    {{else}}
    {{#is section.id ######}}
    <ul class="article-list">
    <li class="article-list-item">
    <a href="article URL without the text slug">Title of the article</a>
    </li>
    </ul>
    {{else}}
    <i class="section-empty">
    <a href="{{section.url}}">{{t 'empty'}}</a>
    </i>
    {{/is}}
    {{/if}}
    Add article to empty section
  7. Click Publish

Adding a section to an empty category

The workflow is different because the code incorporates the else /if statement that displays an empty link within the category.

To add a section to an empty category:

  1. In Knowledge, select Knowledge admin
  2. Click the Customize design icon () in the sidebar
  3. From the theme you want to work with, click Customize
  4. Click Edit code
  5. In the template editor, under Files, open category_page.hbs
  6. Replace the code that goes from {{else}} to {{/i}} with the code below
    {{else}}
    {{#is category.id ######}}
    <section class="section">
    <h3 class="section-tree-title">
    <a href="section URL without the text slug">Title of the section</a>
    </h3>
    </section>
    {{else}}
    <i class="category-empty">
    <a href="{{category.url}}">{{t 'empty'}}</a>
    </i>
    {{/is}}
    Add_section_to_an_empty_category.png
  7. Click Publish
Powered by Zendesk