How can I display an article or section in multiple sections or categories?

Question

Can I put an article or section in multiple sections or categories?

Answer

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.

The help center content is organized in a Home > Categories > Sections > Articles structure. With default functionality, a section can only be in one category, and an article can only be in one section.

However, you can display a link to the section or article on the page you'd like to be available by customizing the template for the section or category. Use the is property in code to display the content in an additional section or category.

To do this, you need the ID of the section or category. Find the section or category ID 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.

Select the option below that best describes what you attempting to achieve.

Article to section

Section to category

Article to category

Article to empty section

Section to empty category

To add an article to a section

1. In Guide, select Guide 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}}

   
7. Click Publish.

To add a section to a category

1. In Guide, select Guide 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}}

   
7. Click Publish.

To add an article to the category page within the {{#each section}} helper

1. In Guide, select Guide 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.

To add an article to an empty section

To add 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.

1. In Guide, select Guide 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}}

   
7. Click Publish.

To add a section to an empty category

To add an article to an empty category, the workflow is different because the code incorporates the else /if statement that displays an empty link within the category.

1. In Guide, select Guide 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}}

   
7. Click Publish.