The Popular Search Terms extension allows you to display a curated list of search keyword suggestions to users in order to help them find helpful content. When a user clicks on a keyword they are taken to the Search Results page to view results for that keyword.
Suggestions as badges
View code bc128aac9292b639d2a72d1c9a76271a710ea1401ca4cdfe8694e56d29af7ccaa300c458eda82624b3cd17f4c37bcffe47ad0406e797a1f3595405dc33d8028f1228266551ca4f6cbe66151ec1b981b69761b7c6ceaefd9b146ccd3794892b1a35ab9731a5bda0152ad1bc89bce5293963a0ed2280cc163bb4f21aa8ac230d2f2eb64244314f49fcfb4cf73a3e8e9452ef0ad573663fffdd1f92319f29ec404ae4d70c0b368535ef027be3e610e7e6ae92cb9476507d2a327157c7ac30703b209737a099ef73fdb513668fe02e7462274b06160d5f3fd60f03eff2ff7f96901f54b83e21e558adf7fed885fa13bcd6978f2252d3c7fd64b0de6c0c305377db618ecbfd96146f7a2d33b4636309f61179b01005b0b4bfe32e6ace6a0a0a6022088b043014aae01a9ecf2ae2dae814f7c46ffbcc5329ca8e96e728d3935e415867b368de75cd87f0f6a8be9e8fc61a5d9cbe508f5cd6cc1134bb88640f6a182eac143220133af7569a627330f81cb7da96de3ef8d1a58bcfc18aa3b6e19c2836fcc200f55bccef90f4bdf2bd87b56b41f5005cf6ea668f5fd562ca403dc2c580089b47a47db7d3eadd59e2236885ff093cdfef67a093e48af0a03cc669f6783ffb5a64bff4cf64f592b5be870ea14fdd0ce2abd9a419e66eefd19ac396648591c751c48869a17905970cc12a52a2343ce5258ab31ca8e2b5bd424c089240d49967eabe9eee3f3d40dc3f754f0684df25a77e6d0fa6628bf5e4f54c3d6ca819cc0a7daa2786c74655a462a0b8990c782dad2b0036b7e4a3b658ccea5ee5023e387dfa4e0dad834b27db65f47f2a129b25a243fa1e7adb591ba305d4c86b35a11231b034ff4cbb124b8761d9b45dce01de07b7ae92f574d786b1d1b67ffdd53e0fdc692a5d3d2b9d4e345acbffe3fdf0e3ae1c1e9ffc8baf00fc68ef8f9f7331874406e620e527539d5db6ad5fa771270da6fdfd3adfffb529745e1b673204a51d9702d87d8cbe0d6c94004b2bc7bfb219890a05f1323aff10e33cfe4cb6aa4a06c974d5a550d9a8e82479cbad79d2964420c49c391736755a035d49d391009b0191444b3ae12b23b69f0a76b2536486543f920b42fd12eb1460f675cc49bc143a693e099e5df2b2eb2d584eb241f2b02a5f5f44ab9223d9043fc2285100b806c0be0a196d9a8a15f726e564436ea6ef97bcc09c92d5ff2cb1a50af05ce00acf7b74fac463349cff4fa257c0e22896978e2f40115edfc870e0b8d5f1c22a17d3e90220322d025e5f6d717408492062c4db6465fd4dadae10f2e112ac241a92c0c3727cccd3d47ba54444f2f6e82ca6445537423814cf965544a709bd51d8184dd10f22de47bc6b3ce87df52dba5c61225cc4e3bd5dba5ec9077c4b78052b900de5ee2d38f85ac63f661802cc406588ca79101d7c299f000da9ec6116a8bb493dd993d10dd069893b79a900a2d634f11808244e3506e7afe65004ccd9160a17bd5808a065cc51d4146f19877944452eff5b73f98183e4e0ddcac6574616920dfda37426cafe0257e6697d4a8774899d8db23e8dd24d8d1e5c9ba51bc9977e61eb0f25254e25664ea9a8304e82f95ff3c55092b390d90fd62f244f3e8e1cc1b7a74fc32bdfc5e9586c4d3af1dc1bf65a7eba99c5fbc7f3cf75e4c61866021c272cd506463c5bcbe0e1083a11233dba6613003cc41b7ba920915bfe3d6dc11d93d677bb9cebf612b11e4cc440d3599f8c65745f029c276e3d7fdb6b2f098ddd2c388887db20c7aa95a941ad729393bdc44a9c40148d1e1514e619bd580a9f3ef5d1efd58b0ed077df536f716cc46f7608be8b0f5a47f77ec7d86602224d0b810093f7c84d393fb30c0d3c9769ee6c5d18d33b04e40785fe633a02ce7fea14a1519c1ae7b67b270d626913a24e3bdcaa5998aa7f9368956bc097b23a8300dc49ec9fca0869c2c50f32a550e997bdb1afbef40769ef29ffe1fe73fea1bccf589598cb2649a4c94f707273b11243e0bb8c500d32b455213a5dd42444eae88d4d98f1963b75167f104f7ba30f96c782ce0b3ebd11b7d718275177a08d6338bf9ad53569fd1743342e5f9adf25a9d4d63f6c0bd17f639f12d4768b88a3400099275527681ee7c8c30b53819cdd27aa584272833d16c7a355dfa8adb8ebcc9a499d7f47458d64cdb35d4aa82931817b36cef4184e6dfdbff17106eb24f27742509382993a9579f940bdcfd037f6dc18e078fc5cee8fedfedaca8ba85ab30cf42f14c5e1fbaa9fcd7ec493803c127f0c34d334c60a4818128f43d6140bb746014a66194470211052417f5a160e26836e02daf4e917510c02610c63bc15f1809b6f9d1fffdf0ee0c6364ee950a0dc2f31c2ad266f099596613c526e833c2b079efd51879641406083c574bb1f8491c3ea4787a8bc2f03bf833f4380df3f5dcde2761dd0fde91fc33f4ceda64db7413b32e925f109a04054e37392a1859b867859278f27c0cca5a6
Suggestions as badges
View code 44a3c01abae6e9f3c98850c22b9af2c705dc946c833c1b10d5b9c0170a39c583919725ba82971f1b4007f53e31d8c474d549282cf83f6ebb93b99d250124702267bb32e0f8023b07961b51d1046fc53397eadc2f1419aec64756c6e19f1ac94a5bec0856e3cbd85f0a903930a81a5fc10234a881d6608cd20ca1d14ee6eedec1e77e4cf8d3fef0817f0b5dd62ca31eb42001e46f4964b6b15a74750244df4ce770fac10d6a798ae4dc02823be2fc8c6b2a9f6af5ef89582ea930d1a67b9233071fc7a6c5a3ea725881c8d3b7f6fe03a7a7865efbedd32556fa4ed63ba22c83dc94702df9cb262e1b2c2ca0bcb996ca458678a6aeea9633027c16af4890c33706c209afc8b8bce818f7ee3ebabf01aba8a89ae84c719ca71d101adcfa73f5e62c6dc9b157f4b60d8dfe8e9e4f3bcb5fd5bbae94c5bfd47aa36807617afaed0690b471a65aad4ea1399de1b3852376cf36949bc160533d3d3e161511fb1af7181d0ce8b70ae6fc23e940f984b54bd21f67ca72544c440d5d509b1202fab1327fadfbd983ad5a8a92dc0cbe5a9611a604f8e9b5cce4198cacf19844fdbbbd8f5a6b0753e2148de01b17e6aedfffceac4d19b63a9b2104d5205c3c78ce4459f255f2681e004f358a394ca917811a7d4d64860a50955e04002ad941f98bc10eae3f016554e36d2d062b18d28e4c18b8e971124d6d14238af87ac342f2965975bd9a40168716fc8bd84ab108099b81df71eb9a725bac6fcd6141d9c950670de87007e39985339578f7f6b7af8d37ba39d61b8b86a768b9bbfcb5a4aecb64afa4cac4c03dd9aba5d74539fd20e901ce78f667be794764fd2155a47e76021b36d44279407e0c5646a5c1baf603c6c04a78325b5018a8b08d406380c29935129951c9521e812d4bbc01066d421943b7405ceb5606337620797da632bb2ad90e58a76555a24d2d595e8262ab36612fb370f7bf76be9f22ec42544c4907be46ed1537d804b4e542b36c1a87c7187df50fa44f47b956bebb7474a09563535a170a7a3c57eb716a29a255cff77227a6f6845776544728d20dca05cc601f2ef23aa89a47218e6f6cb55f82b922ee4216f3ddcf48689f499eb5e2d3b862a9b6fd017c9edceebe304d2cb2db34dd636e03ede259dcaa6351678c8cbb20d968ad381ea3f1de84ec8f8a175bb1a507d0b7912756ea5ace68e2df261c6a21b5671cdfce6207bc7833aa5d5db8f58442bc082ff2249f33c4efe5b9422d0c3a8756d7eda65dd10265d1db99ddabb2fbf0ca0c1168624fedbfb4480aa8753d7096544c07ab6dfbdcf76c3c305ce75ea6d6ed4f4ed34c43520c75bb775aae364fb4a82bc76d13cb3515bac9a8883583eef7c0afe961c6a9c724cf7c3067cdea2787a6790dbaad7ec936c5d3394c47b8131bc87a2b97c4257b29237c20f1fe0382bf5a48c7893c9ef0c717dd954e9c98e5155eb3d6927ed2bef74639b0a173302131ab4fbeb87b7be47ac7ab194f58a5129b588e32fd0de1aa7ccf3d20101024296986ad2cffa5531e820105468d1c7957b1b5791e20eaaed648bf97b1c623907fc57be728bbe94c70235bfd77ef99ba3012ebe3a285f2fbb4f1274945758a7c8c61964352a6b92c567975df9c8681f353cfca4b57eb59fd6767e36fa44dcff3b3717eb93b8963ccde900098a00dbdd261d0954998030b94ad6c82bf81d43f839aa124c8b81bcb9875059241428efd689cff6de0af93f6f99ab48e9583622cf8ee23947011581f15024363f497878428ac3f6b6436285598c51c89e1640929a3f36d9c464a4189d34bd3b52e1d015ed9ae14cbad0e4d3317e72597501d5b9dc4df76fea5f83177f2af09f79570ae6652f1bd7ec6fc52138312f35093c1d02d236a1c8729e0ed814fd6bde1a5cdf2123d6e1edbf1f542b545914486576b6a55cfedfc54adef374587f5fd149760240227578a65855b1c3046ae7510cddf3484141f4ddcad5ea1f15bc35090b6dfc020e66ad2d009e5850251662abf86e3ea448cd9c35f0993adc5b875a4e94240722f59fd98f4120bed414f571e29e05d0974d177c47e075aba14f51f89b4751e390ac95c9764db3863e7bdcd507609244efb4f17787938d221a30f1283095d7ddb21519c0c8b62b799a7e71e9cb621b2f9890d4bc2a83c6f6eb014da8742c86176000b8a64b9720234cca8f49015ae0bbc332310aa0dcbfab8b24f31c57935c4f3b37e8986565d358bc94a838251ba912bd325cd3359e3b04abe4c7965a49f293095b892b2ddb2becf3123e7a762206e79888249c7bc4d54dd9be3e72e603d54b44b13a9e89ba0de95809fde5f844213c3b2417364368cf39b42fca0f4f3f785c6bbdde9f009b70e429e15e61eb331d8f46b5d8c65fa234fc6a58a8d934b8a4e5faec708cd99c9383fc7db35672fa767afcac3b3bb4a6af7e3144985212c67718d213a984979949b159c23d7465e73773f18c4da3f780d85217cdeb3ebf4c6
The Popular Search Terms 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 list of popular search terms on the Home page 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 Home page elements section select a style from the Popular keywords style setting dropdown list. You can add an optional heading using the Popular keywords heading setting.
-
Add one or more search terms to the Popular keywords setting in a comma-separated list.
If you’d like to display the list of popular search terms outside of the Home page hero section, you can copy-and-paste the following HTML and JavaScript code into your desired position:
{{#if settings.popular_keywords}}
<div id="popular-keywords">
<script type="text/javascript">
document.addEventListener('DOMContentLoaded', () => {
Util.renderTemplate(document.getElementById('popular-keywords'), 'popular-keywords', {
keywords: '{{#if settings.use_translations}}{{dc settings.popular_keywords}}{{else}}{{settings.popular_keywords}}{{/if}}'
});
})
</script>
</div>
{{/if}}
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.hbstemplate. - 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.
