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
Adding an article to a section
- In Guide, select Guide admin.
- Click the Customize design icon (
) in the sidebar.
- From the theme you want to work with, click Customize.
- Click Edit code.
- In the template editor, under Files, open section_page.hbs.
- 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}} - Click Publish.
Adding a section to a category
- In Guide, select Guide admin.
- Click the Customize design icon (
) in the sidebar.
- From the theme you want to work with, click Customize.
- Click Edit code.
- In the template editor, under Files, open category_page.hbs.
- 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}} - Click Publish.
Adding an article to a category
- In Guide, select Guide admin.
- Click the Customize design icon (
) in the sidebar.
- From the theme you want to work with, click Customize.
- Click Edit code.
- In the template editor, under Files, open category_page.hbs.
- Place the code below the
{{#each sections}}
helper.{{#is id ######}}
<a href="article URL without the text slug">Title of the article</a>
{{/is}} - Click Publish.
Adding 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.
- In Guide, select Guide admin.
- Click the Customize design icon (
) in the sidebar.
- From the theme you want to work with, click Customize.
- Click Edit code.
- In the template editor, under Files, open section_page.hbs.
- 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}} - Click Publish.
Adding 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.
- In Guide, select Guide admin.
- Click the Customize design icon (
) in the sidebar.
- From the theme you want to work with, click Customize.
- Click Edit code.
- In the template editor, under Files, open category_page.hbs.
- 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}} - Click Publish.
39 comments
Christine
You may want to check out the following articles that might help:
Thanks,
Christine
0
Laveeza Yasin
Hello, everyone!
Has anyone tried using the "Help Center Manager" app. by "Swifteq" for arranging and moving articles on the Guide - Help Center page?
0
Duygu Gözen
I have the same question as the one above. We have multiple languages how can we adjust this code to support different languages?
0
Thanursan
Since no one seems to have posted an example of multiple such articles in a section, here's an example:

Also the Zendesk Team can update the article to include:
'Wrapping' each article. This will ensure the article list formatting remains the same.

This is how it looks like:
1
Paul Dandurand
Dear Zendesk Product Manager,
This is such a common request from your user base. I wonder why you require folks to set up custom code instead of Zendesk just adding an alias for articles to be located in multiple places within your structure. I'm guessing it can't be hard to build.
The following is one idea of a draft requirement for this suggested Zendesk feature to help you think through it. Maybe it's more complex than I see it, and if so, I apologize for not knowing. :)
2
Nicole Saunders
Hi all,
Here's the official feature request thread for this functionality:
Allow articles to be posted to multiple sections
This is where the product team will continue to provide updates on the request's status, so I encourage you to follow there.
0
Cristina Galera Molina
What about languages? How to add the title of the article so that it can be shown in the user's selected language in our Guide?
0
Joyce
Are you looking to translate the article title and content into different languages? If so, you can add a translated version of your article based on the languages enabled on your Help Center page.
You can visit the article Localizing help center content for more information.
0
Sean Farrell
Hi all,
Is there a code based solution that would allow us to display these links depending on the article's publication status? The problem I'm running into is even if the article is unpublished, we're still displaying this link in the section designated by the section ID in the code.
0