Question
Can I put an article or section in multiple sections or categories?
Answer
In 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 in the page you'd like it to also be available by customizing the template page for the section or category. To do this open the template editor in Help Center > General > Customize Design > Edit Theme
Using the is property you can code in the reference to display the content in the additional section or category (see Help Center template is property). You will need the ID of the section or category. This can be found at the end of the section or category URL you want to add the content to. For example, https://yoursubdomain.zendesk.com/hc/en-us/categories/#######
To add an article to a section:
{{#is section.id ######}}
<a href="https://help center article URL without the title">alt text</a>
{{/is}}
To add a section to a category:
{{#is category.id ######}}
<a href="https://help center section URL without the title">alt text</a>
{{/is}}
To add an article to the category page within the {{#each section}} helper:
{{#is id ######}}<a href="https://help center article URL without the title">alt text</a>
{{/is}}
If you’re adding an article or section to an empty section or category. The process is a bit different and involves incorporating the if/else statement used to display an empty link within the category or section.
For adding an article to an empty section there is an {{#if section.articles}} statement. Within that statement, the {{else}} statement should look like this:
{{else}}
{{#is section.id ######}}
<ul class="article-list">
<li class="article-list-item">
<a href="https://help center article URL without the title">alt text</a>
</li>
</ul>
{{else}}
<i class="section-empty">
<a href="{{section.url}}">{{t 'empty'}}</a>
</i>
{{/is}}
{{/if}}
For adding a section to an empty category, the {{else}} statement will look like this:
{{else}}
{{#is category.id ######}}
<section class="section">
<h3 class="section-tree-title">
<a href="https://help center section URL without the title">alt text</a>
</h3>
</section>
{{else}}
<i class="category-empty">
<a href="{{category.url}}">{{t 'empty'}}</a>
</i>
{{/is}}
64 Comments
Hi ZenDesk team -- It's really frustrating to search for how to do something seemingly basic, only to find 8 years of threads pleading for the feature. I totally get that unexpected complexities can always pop up, but from an outside perspective, I don't get how it takes over 3 years to add a symlink. I'm trying to make the business case for my company to upgrade to Enterprise, but that's difficult to do with a limitation like this. I'd rather keep our docs in the same place as our support tickets, but if my "Alternatives Considered" section includes tools that do more for less money, it'll never get approved and I may get stuck with a migration project instead. Please help us stay with you. :(
Hi Ashleigh,
Functionality to solve for the issue of not being able to share the same piece of content in multiple places is in development, and has been for some time.
Announcements about EAPs and releases will occur in the community on the feedback thread for this functionality:
Allow articles to be posted to multiple sections
If other users have feedback that you wish the product managers to read, please post in that thread in the community. Product teams are not subscribed to comments on articles and will not see the comments posted here.
I'm all cool with showing articles or external links in their non-native Sections.
However, I'm currently trying to show a Section in it's non-native Category. My code looks like such:
{{#is category.id 360003321194}}
<a href="url for the section">title of the section</a>
{{/is}}
However I can't seem to get it to
I think the code is correct, and that I'm putting it in the wrong location. Any thoughts?
Hi Rachel M, if you're not using the baked in Zendesk behaviour then you'll have to do some of the heavy lifting yourself. In terms of your first point you should be able to use the same css classes that Zendesk applies to sections on the Category page to get the same look, so:
{{#is category.id 360003321194}}<div class="section-tree">
<section class="section">
<h3 class="section-tree-title"
<a href="url for the section">title of the section</a>
</h3>
</section>
</div>
{{/is}}
To get the articles within that section you'll need some JavaScript to make a call to the Help Center API. It would include something like:
$.getJSON('/api/v2/help_center/en-gb/sections/' + [YOUR SECTION ID] + '/articles.json')This will fetch the articles. You'd then need to get the details and use jQuery to add the HTML to your page.
This isn't a complete how-to, but hopefully it's enough to get you started.
Please sign in to leave a comment.