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 3ac23813444cc8a211d3fa457fe3a6e8a95b5a02b4a1e3086d0f42bb6e9d255069e5d8739de68c71db5c542c0c92ed42182ae3b224108ad8bc366ca03c0cd929b1392c05f2fdbcd8338ef10369f9d13f3585ec43f9a831facb61934c0994a5b77285dfcc88935928cd5b76c73cfdd6907df09a334601c91f993a2d0305e9b91c8c3e4f078ec3ec3b6a40d2e8a76790664fff09c44edcf91111ea26a2d9c878a6e8b1774a5b68be19a0dcf780ceac226b187d08bc9c6d6679da18f4644e8fb63205d16d8cdbec87a39d0966f9103313b13a1efd6d8cfa9a86c53459411ff108c5660af5d9e67bdeddbb675488e71f6b8f567b655d82ee84184da292a80c0acc795d0617ae5151c8f07d7b55691dac120f6b56a5a6ed384c166de02ab6e19ef2e69f52302f6e4ce3cac7e2012f5c5238451f07e883855279892fb5771fda27f4a65a932c82deeff290f2394832fdbf1629e1e3509a9bb7ddff9566037c668a13c93bfaac1bc4a278b39879eedd88513e7d52110fc67283aca952d3dcc41544271c597d0a8623722783fee3b92f97910e3427d7831c05f1994dd5cb8a2b89bf3e0d5d7be45def9b54d472877f13b177fc338ed23b750877ab2c569dcaedf6a7b89f1042bb4517c1b74cbffa6b770b2936a7e1ca8bfa73a78c82cf1c08b6f493e01cc5b50aa102580c1803c6461261a3b7f743d07831eb1cbdd69fbdabb3edd3c680f6050c3fcd11fb367a3e3fbf0e98f1a8e0cba217a38324f2c4c738939d33646b8059e877ffbbc7e1e0651f51d31455c7bfe348d1eb9c4a5da220ac968d31f1619b05992e1c3352980b8769ffead8da5c6034ad9402b0f0bd0abcfc2371128f57ef244d3a121851f0e55df97cadb7d22ad8f82192fca5251821c3baea74614d800796883109f55d6d5bc3117e43ff1392840162e079bd06df3600517883656b1d833ce211bf5406d8305461c5453e54f8dc533a80982e37ede97eb02c43a54670687398b1a5df3d28ba1c31db8722ed1a168103c5813b10a07262749ec8be91a9cfee60c8c3e4d551291bd5a3f23238a6f9cc42753f4496179a15f9fccc4f7301d234cb4cd6514b799a86aa666dc385a63a1b5a3d044c10a8e345ecd495755dedfc426efa6354d5fde935649799853aab0c125327c7a00b03fc4a71bf6591dce1bd87bb2321919bbaec2e94f22128e60681d8e3ad1a1880fd7685a113e3f93f655a11128ebf031a2a3ec9e162a6724b54132a29b93949fd6a9c5e10730a5ea135d619338de7d880c7cccee926ea1c843887021bca5674c7c510491423fec4683584ea7a0d6fe3fb5c8f9933d6e870107a262c559b1ebce475a23ea39c1792d8fb2a04930c3dfbf23b47fc7bc77e28b636ce6b496562312f021a37d17eef8c2d05c76e0d952f8a17ecade0d08f87ec6a1fea278d2b523524fef8fd93e38981500c82c0df9798165c9188ecdee62a1bb5cdecf599282c9dab8364d8e7e2dfab793d6608f9a26c0256b37a140a676e34026c0973f085cbe1b12b7b615c4509aad39e5207886c22922dc5d21051128254b3d9c2e8becdcfdd48e1b7e969d60c7df1db59d67d29d9c1f3a88d13f6a566873fce7a5d4167c700dd78972ecbd914a8040dcb8522c3224dda67565860bf177024df7e07af737319c08a49bd141809aea9a9712a6a7423acd65814f9944bb4f19901e799128206be8524354d3f15b718c004ee1c04607319dd2fa71fd1666bfa2722e90554292b219cc4f537b3c0e0073694c0bb2eb38ac1b648862e652120f659e242a2641397596dbd5829bf579f4fd593fe0be360680aeb579b87a89fa92ec8e116836e9675419d0d2564e3e0aed6aadd1b6ad541f7d4bfd25bd412aa1248b04c487e1b891ccefc11d46420f3a70cce5b714040140ebcfb8a5885975884550774c96dffd6d68957010d6e3fcd9b3e2f86584e47b994638485b5e82bec0e5534f049af09e0d10b8439afd94e4779c3b91e5163da1cb4fa4f987ffb77379a96141b3c1962f977da290938ff3a01d3124d6e9683fb96977d24c650b5b49086ee5f50eabc3d058c0d019077251a1a725142c77e07262d7106714cf8f320296716e33f1d00cb509464705b54523d243f889d915a663a588a7edcbc5f3c98a42fff29a3030d638b7e35d8c77f671b64cb0eca2fa93ec0e6d7089586f88ff3c999261e5ba32ae5506f052ebd693258aa6b54f217a94eb39b5f368533ff86641d1643d2bc70ede5310ee788b487d0b30b68b6d38e49fe2f440c3d2e8f2e40ea985d0f5a2b403664020b3fca22d0aaf3bcb456a10458516c80477a7d86636aef185268bc4367f3af465ac04ffe7f1ab461505b7ed1fcb85d46505b92c80cb8fc037ed185739fe210e6f8ce50b1ccbba758db843c1372f7a1bed0e55fcc4cb3f901672cd1d55def6b106e6453cd17b9a902e326bf9e087cca3f043d63354179b4de9a7b7063404c4b9435ce6ebacf33ed0a6ea26d8c
Suggestions as badges
View code 41ba6f31dc9e6e20fde289e61e7a097e20ee85186ff920505eb50d852735dfca164a5359e36527fe4165ed76e4bafe16fab408cc2547e714e595e922869b551a84f57e18d54913ae5461ed269d474abedbd0b93252380b706df8189698f8a9aa4f8cce6d08a8a81b596b3b65c984b6889765aca514231ff4509aec74174cab61b0c617034f38f8ee5834866359e51a92caaf3ecfc89f7efea65ba6a0886266195d5e1ee5e33c09ed58796321d5833f44325053ceeb980cad9201757e154e83d0ac1e9f6f573aad217a2de73f557c500142ca479814088c2dc0de698f75ce76db665baff2f1e9150c83276cedf2f1e2aaca87e635739812d549c0bbc9b586db766e2dc709304cf7841f4cc888b0c72e81178843046e40c058a3959095dc44a09001532765d097f9df9cf2c3c4986126f5eeaeb79b32c46c2bcf438aa577b9e351d7a010673de8f95d585a559d6793fa4d9d16840c3c6727035226abc859c4e5f4a15b2f09b15dcdbe2acd0d9dd6e367c1d4cb5181eafea7f38b87a5496553a7a24795962c7c4be9563116f06aa6e6f7608b36554f1390ff6044a2d73eddc1a5ee448e92668e7592436bc3f2bbdc888832ef27097593257a1e6a042218fa665e3cfb39b8660806a8933ed30cbfb6d746035069c0410cca3d39af4e5f3b2f9bbd819375a3e5b181e439c348e89d557b2803b9ab011cee3a3ed7562a499bbdfc545632286aa7056916b13e121bd6a76ee3720325f3fd3420a9e118e71ed9cad0e6908b9235c524d2691f28e133f5af043932692273939d884ec489548c169868837691c8fc82e98741b2406f4c1aa2542076a1222a42670f7da3ebd0e07846eddee40cba664b4f6a46a3bb6100f9aeb521c9ce7c4f03e5fd99e7b996a48caa2dd9a2ae92cb4154e4c7c6faf9825a33a086c57caaa5549311771fa825ad7ba1c1d3fa54229a4a7fbd97e7bfbb39da732a638a12fc84f33d08d12d8b86d114d7ba15a310d2b6a26aa19cd10228adc77464a84255261177fd54cbc9fcb13f5b588bad21b1b39b87d52f308b1c5ab195ae053d54faef94a2e8c52266a54f84c88b3ebe80f438ecdda6788033b0a83dc3fe94804298f44ec58cdaedacedac6a3d5a3b34f0d51139b2bbbb30cb4fe96bc4adbc76033da5c932d000f34940518ca4d2170da4d6f4a0cf5a1740dd39dc93b10fe99d1178643f72825285cd383c8ad4a7ecf7c944366f96c761fa251495f9e8bc7185db1436e807e725a6cf4e8bfa677914ec844713c76c55066830382f5a9e2b0f5d1a1286aafc8dff659c7f3fefaa32ea50e2f07c42b4a247de0acb8fb0495f95cbe07bc70c78b20b5d2f24cdb11eba0657bebe8ffe931ded957d78f38b78fe2a4e27201633eac79909231754e4efd3684f7bdbcda4ed8ce4d2c9f89b2b8956c49fb65079ee2fef35200c192a73c8849a1037874f2071813b203dcffddb9d44f63c6e6d7e8a2510ff8af6034e8db310253df54c548cc2d36eed8c2d35f4aa65873149c85c114c1c45bc559b88fd582fef0828003102a9a8db0288a31b0594a4cd0f41093086219c0f2f55845bd8890b4dee8f433eee45c5e1b4f40c313f5afdc5edd4f9cc5b2b900fc05d350592b9e7abaaece48916adf3ce01a0961b1e2bd8c22e118bf4ac27a2aca6e7e9200f45a791983a13165e8e72e979be862c401dd9b6e5240d53dcb154659c0a6259240a3f6de5da8d26a20f7eabe43fd07506a1058179faba4377c01190a74ae7a39e475d524dcf76790fabccdd6692d4e3dc4f09bb861d9e2f24b41d74e0dbabf0b6fcfecc36ca63c4f31cceaaca1ba8d49153608cbce1d91d6e9a21e32963e5958f37271bc25a8451fe977ee16b53b385cc9c2cdc73ac9645fcb5db32b3f505326cda2b8dd77d3da5ece7ba21fe20d13f58778d2c9b9045362e8479e1a2954f754030a0bf8a0533698ddfb7c56a87206c0c8239163a42128eff4ff928b2a8de08962548182f8b42e76283594f63f0e95baff7cc9b0e48b1a46d32ad6cab3ab9d56251370230a474c4fe3e9881586102866ffb075dc07f8488fdce485041478833e100aec10904a8b62f142e8e6dc5819f0830d553cdf63373c59feaf723424e3ec71c439e1418ec255ef2b17e32458b779eb4c180dd11db50fb2885d7af35e0205e01ed86b6fb448f1dfe59e5073c5b0a0e046577a655fc6389bc0588f49f33d72629960b78a348de17427d3fe007ff8e9250edbda828613b02e2424eb2b4784e468e74d4f9f805925b6573e42b9040a9cb40d900e54dcf289a3d3cea9c959afc8fac3a4b7d7bf56d7b93b2bf0f31f6d877448a04415fb106375615042f50b0dbcac15695cd345d4afb3f970403855f414041486a19bcdeecad5241f14d080c2eaa82ef04c08927fb99cd4a8cb2c818dfb177da83e1d5434ba5806edc4d455ab2304cce1b9902ab2273c04436479b1ff6c83695329700acea46faf1ab49ab891bd0a574301271
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.
