Workflow: Display an article or section in multiple sections or categories

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 a section or article 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. 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.

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

Adding a section to a category

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.

Adding an article to a category

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.

Adding an article to an empty section

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.

Adding a section to an empty category

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.