Promoted article on category section and article page



  • Ifra Saqlain
    Community Moderator
    Most Engaged Community Member - 2022
    Most Engaged Community Member of The Year - 2021


    You can get the promoted article code from the Default Copenhagen Theme - home_page.hbs.

    See, The promoted article code is below, copy this and paste on category/sectoin/article page at the bottom but you need to fix the UI using CSS. I have copied the code from Copenhagen theme.

    {{#if promoted_articles}}
    <section class="articles">
    <h2>{{t 'promoted_articles'}}</h2>
    <ul class="article-list promoted-articles">
    {{#each promoted_articles}}
    <li class="promoted-articles-item">
    <a href="{{url}}">

    {{#if internal}}
    <svg xmlns="" width="16" height="16" focusable="false" viewBox="0 0 16 16" class="icon-lock" title="{{t 'internal'}}">
    <rect width="12" height="9" x="2" y="7" fill="currentColor" rx="1" ry="1"/>
    <path fill="none" stroke="currentColor" d="M4.5 7.5V4a3.5 3.5 0 017 0v3.5"/>


    Screenshots for the same:





    Hope this help.

    If any query let me know.


  • Kajal Chauhan

    Thanks for the quick response and I am able to edit CSS.

  • Breanne Brock

    I tried adding this to a custom section page and it shows all promoted articles (like it does on the home page). 

    Is there a way for it to only show the promoted articles that live in that specific section? For example, this highlighted "Coupa FAQ" article (#1) is a promoted article that lives in the "Coupa" section (#2). That is the only promoted article that I want to show in this section. Is this possible?

    Thanks in advance!

  • Ifra Saqlain
    Community Moderator
    Most Engaged Community Member - 2022
    Most Engaged Community Member of The Year - 2021

    Hey Breanne Brock, It is possible using APIs.

    Happy to help :)

  • Breanne Brock

    Ifra Saqlain - I am not familiar with APIs. Thanks for responding.

  • Jupete Manitas
    Zendesk Customer Care
    Hi Breanne,
    In Support, we’re happy to help demonstrate, troubleshoot, and ensure functionality of our default code. We’d be able to work through an issue or question with a specific part of our default code, but for your use case, this can be achieved as mentioned by Ifra, through API scripts or the custom coding to change the behavior, view, and look of your Help Center theme. 
    We do have the following resources available to help your developers regarding Guide customization:
    Help Center: I would recommend starting with our documentation here:
    Customizing your Help Center theme.
    Help Center API Helpers.
    Help Center API Advanced Helpers.
    Our Community: Zendesk has a very active online community where customers and support reps come together to exchange tips regarding their Guide customization. You can check out our community forum here: Zendesk Community.
    Partners: While building custom theme or code in your Guide is outside the scope of support, we do have partners that can help you with this, you can find the list of our partners here: Zendesk Partners.

Please sign in to leave a comment.

Powered by Zendesk