Category dropdowns appear in the page header, providing access to all categories (and optionally sections) throughout the help center. They are fully responsive, meaning that they’ll look create on desktop and mobile devices.
Like other navigation elements in our themes, the list of categories is dynamically generated based on the content you’ve created in Zendesk Guide and will automatically reflect changes that you and other help center managers make.
The default layout is a single category dropdown, but multiple category dropdowns displaying child sections can be easily added.
Because the extension build upon our powerful micro-templating system, you can completely change the look-and-feel and functionality of the dropdown menus. You can even control which pages they appear on with a few tweaks to the template!
This extension is bundled into all of our themes by default, so you can start using it straight away. It builds upon our powerful micro-templating system and gives you full control over how the search terms look and behave.
Our themes allow you to add a category list in a dropdown menu to the page header using theme settings.
-
In Zendesk Guide, click the Customize design icon () in the sidebar.
-
Click Customize on the theme you want to edit.
-
Expand the Header elements section select a style from the Category list style setting dropdown list.
If you’d like to display a category dropdown outside of the page header, you can copy-and-paste the following category dropdown hook into your desired position:
{{#isnt settings.category_dropdown_style 'none'}}
<div data-element="template" data-template="category-dropdown"></div>
{{/isnt}}
Our Navigation extension allows you to create category lists and navigation structures if you’re looking to display multiple category dropdowns or all categories and sections in a more general layout. To achieve this, replace the default category dropdown hook in the header.hbs
template:
{{~#isnt settings.category_dropdown_style 'none'}}
<div data-element="template" data-template="category-dropdown"></div>
{{/isnt~}}
With a Navigation extension hook and template:
{{~#isnt settings.category_dropdown_style 'none'}}
<div class="flex" data-element="navigation" data-template="multiple-category-dropdowns"></div>
<template id="tmpl-multiple-category-dropdowns">
...
</template>
{{/isnt~}}
Custom micro-templates
Each theme comes with a number of built-in styles that you can choose from using the Popular keywords style theme setting, but you can add additional styles to your theme by:
- Editing the micro-template of your chosen style on the
footer.hbs
template. - Copying a style across from another theme if you purchased our Complete Package.
- Copying a style from our Pattern Library.
All popular search term micro-templates use the same keyword list defined in theme settings but can differ significantly in terms of their look-and-feel and behavior.