<head><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style></head><body><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p><strong>- Enabling the Knowledge Base Area</strong></p><p><strong>- Showing User Article Views</strong></p><p><strong>- Set if Users need to Login to Access Articles</strong></p><p><strong>- Showing/Hiding Article Details</strong></p><p><strong>- Pin the FAQ list to the page </strong></p><p><strong>- Allow Users to leave feedback on Articles</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">Enabling the Knowledge Base Area</span></strong></p><p>First, the knowledge base area will need to be added to the self-service portal. Go to Configuration > Self Service Portal > Menu Buttons, and add "Knowledge Base" and/or "Knowledge Base Search".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4MmFjMzNmLTA1ODktNGJlZC1iOWQ5LWYzYTJmNDQ4YmY1NyJ9.xdPVwF4kFOFc1MI9r-xxNbKvcVH24b1FsuUHlZQ3qL8" class="fr-fic fr-fil fr-dib" width="711" height="358"></p><p><strong><span style="font-size: 10pt;">Fig 1. Adding the knowledge base to the portal</span></strong></p><p><br></p><p>These will then appear in the menu button list.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEyYjViMjJkLTZjNzQtNDE3MC1iMjdlLWJlNDI4ZjllYWM5YiJ9.NFYeBD33QpqKg8nP_5afqyqGJyhFYJ6paHSjaDs0Vu4" class="fr-fic fr-fil fr-dib" width="327" height="132"></p><p><strong><span style="font-size: 10pt;">Fig 2. Knowledge base in the menu button list</span></strong></p><p><br></p><p>These will then appear as either tiles or within the navigation bar, depending on if you set them to "Show on home screen" and/or "Show on navigation bar" when adding. Below is how they will appear by default on the home screen.</p><p><br></p><p><img data-fr-image-pasted="true" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmOTM4YjlhLTZjOWUtNDNlMC05ODBkLTQyOGEwMjJjYzAyYiJ9.GcEHyOqqwtNN3TG2YYIVDyzMlW8VVsurs1nR7Dl-eLQ" width="987" height="244" style="box-sizing: inherit; border-style: none; cursor: pointer; padding: 0px 1px; user-select: none; text-align: left; color: rgb(0, 0, 0); font-family: sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; max-width: none !important;" id="isPasted" class="fr-fil fr-dib"><strong><span style="font-size: 10pt;">Fig 3. Knowledge base button on the home screen</span></strong></p><p><br></p><p>Clicking into "Knowledge Base" will show the below view by default, with the FAQ lists on the side as well as the most <a href="https://www.usehalo.com/guides/2666" target="_blank" rel="noopener noreferrer">upvoted </a>articles.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhjYWM5NmM3LWQ3NmEtNGQ0OC05OTdlLWViMGIzN2FiZDQ2MCJ9.-LM2AZ77o5Ab-FHurIqesXBhJjwVF_m8-NJZSar9mDs" class="fr-fic fr-fil fr-dib" width="1202" style="width: 1204px; height: 669.514px;" height="670"></p><p><strong><span style="font-size: 10pt;">Fig 4. Knowledge base screen</span></strong></p><p><br></p><p>If clicking into "Knowledge Base Search", you will see the search screen, filtered to the "Articles" entity. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQyMWEwNmMwLTI4NmItNGM5MC1hM2I5LTYxOWQ5ZTRkYmEzMyJ9.GTKoKOS7RjtNWVPdZjGbvB7yRn1-PVjVkoQRCDD0I6k" class="fr-fic fr-fil fr-dib" width="1210" style="width: 1212px; height: 523.609px;" height="524"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 5. Article search screen</span></strong></p><p><br></p><p><span style="font-size: 12pt;"><strong>Using Tile view for the Knowledge Base (v2.246+)</strong></span></p><p data-pasted="true">The Knowledge Base can be displayed using FAQ List Tiles. To do this, use the Knowledge Base Menu Button "Opens the Knowledge Base browse screen in tile mode". </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdkNDFiOWRiLWNiNjUtNDAzMi04MDllLTBhZjRlN2E5Y2VhNiJ9.8OwJmgWkv3qnPMcz-iL-K5fXOATOcydjXNQflEVy12E" class="fr-fic fr-fil fr-dib" width="1227" style="width: 1229px; height: 652.25px;" height="652"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 6. Knowledge Base Tile Menu Button</span></strong></p><p><br></p><p data-pasted="true">Within the configuration for this button, you can restrict the root level FAQ list when accessing the Knowledge Base.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVkZTFlYWZkLWMyYjctNGUwYS05MDQ0LTg0OTExYTA3YjYwNSJ9.NDKf8m-VqWX1B87QDHqA0JhR28DRhMbJH0EPjRDLLFc" class="fr-fic fr-fil fr-dib" width="709" height="475"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 7. Root FAQ List for Tile view</span></strong></p><p><br></p><p data-pasted="true">Each one of these tiles can have a customised icon, and up to three Articles to show as a quick access, useful to present your most visited Articles. To customise each tile, you can adjust the settings per FAQ List (Configuration > Knowledge Base > FAQ Lists). </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJmMzc0OWI5LWJkZWQtNDlkYS04OGQxLWZjNmYzMGRlZjU0NCJ9.Zx1ngAqtoTqE4z-niCAaHpTanlTBxvMKW6ppM2jEtW4" class="fr-fic fr-fil fr-dib" width="986" style="width: 988px; height: 704.59px;" height="705"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 8. FAQ List Tile settings</span></strong></p><p><br></p><p data-pasted="true">When clicking the Menu Button in the Portal, the User is shown your FAQ Lists and a new search bar.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRiY2VlMDg1LWQ4ZGMtNDg2Ny04ODU3LTg1MjU5ZGFhZjU4ZCJ9.tcUp1w93nfUbgWnOHNgz4h09262yJTbTQwCoPiwso4g" class="fr-fic fr-fil fr-dib" width="978" style="width: 980px; height: 577.883px;" height="578"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 9. FAQ List tiles</span></strong></p><p><br></p><p data-pasted="true">When clicking into an FAQ List tile, child FAQ Lists as well as Articles in the FAQ list are shown.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEwYmZiMTlhLTQ2ZjYtNGU0Yi1iOWRkLWM0NDgyODc1YTMzOCJ9._EHOYoIly3IsMFCRH6kvO5XZyHBxRhTP4S-ejVfPypg" class="fr-fic fr-fil fr-dib" width="994" style="width: 996px; height: 524px;" height="524"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 10. Child </span></strong><strong><span style="font-size: 10pt;">FAQ in Tile mode</span></strong></p><p><br></p><p data-pasted="true">Users will be able to navigate back to a previous area of the Knowledge Base by clicking on the Breadcrumb.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0MDgzNDUzLWE0NTEtNDJkZC05ZTFhLWZmMTVjZDMxMDhkNCJ9.ODuzPcBrwdNCyg7dvJyfNzF2iNZZhODdgYrVcH0HdPY" class="fr-fic fr-fil fr-dib" width="982" style="width: 984px; height: 492.433px;" height="492"></p><p data-pasted="true"><strong><span style="font-size: 10pt;">Fig 11. Knowledge Base breadcrumbs</span></strong></p><p><br></p><p data-pasted="true">To allow the home screen search bar to make use of the tile mode's searching functionality, head to Configuration > Self Service Portal, and enable "Use the Knowledge Base Tile Search for Article searching". This will also make clicking Top 5 Articles on the home screen take the User to the tile mode view.</p><p><br></p><p data-pasted="true"><strong><em>Note: All HTML elements within the tile search have unique CSS classes to allow for full customisation of the tile mode view to suite your Organisations branding requirements.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Showing User Article Views</span></strong></p><p>In Configuration > Knowledge Base > Articles, you can choose to enable "Show Knowledge Base Article views in the Users activity feed". Their activity feed will then show when a user views an article on the self-service portal. This can be useful for tracking which issues each customer tends to struggle more with or have more questions about.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE3MTExZDJiLWU3MGItNGJkMy05MmY3LTkwZjY5ODE3MGU5MyJ9.TVExksJ3YGJ_dmVhqV--iUpTQOJkEkyrATwPSuuDwJA" class="fr-fic fr-fil fr-dib" width="426" height="41" style="width: 426px;"></p><p><strong><span style="font-size: 10pt;">Fig 12. Enabling view tracking</span></strong></p><p><br></p><p>This can be viewed in the "Overview" tab of the user's profile.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU1MDQ1N2NmLWU5ZWMtNGUxZC05ODAyLThjNWMwZTUzMTJlMSJ9.czU-7P662DgDhne-VB9Dee4-Xm_VuBOci7IfqPIdBoo" class="fr-fic fr-fil fr-dib" width="457" height="161"></p><p><strong><span style="font-size: 10pt;">Fig 13. User viewing an article</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Set if Users need to Login to Access Articles</span></strong></p><p>To set if users need to login to the portal in order to access articles, head to Configuration > Self Service Portal > Configuration > toggle "Require Users to login to access the portal" and "Require Users to Log in to Access the Knowledge Base".</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU2YzZiYmYwLTA3MjAtNDY1Mi1iM2YzLWQ1YzRmMGE4MzQ2MSJ9.aHS02i0pbIvXjuO_vM5vlZ-3LmSZXH31p5fLFyo2qBA" class="fr-fic fr-fil fr-dib" width="1053" height="375"></p><p><strong><span style="font-size: 10pt;">Fig 14. Settings to control if users need to login to access the knowledge base</span></strong></p><p><br></p><p><strong><em>Note: "Require Users to Log in to Access the Knowledge Base" is only available when users are required to login to the portal. </em></strong></p><p><br></p><p>When users are not required to login to access your knowledge base, logged out users will only be able to see articles that have no visibility restrictions and are on FAQ lists that are set to "Show for all users". </p><p><br></p><p>If you would like to restrict which users can access particular articles in your knowledge base checkout our dedicated guide <a href="https://www.usehalo.com/guides/2044" target="_blank" rel="noopener noreferrer">here</a>. </p><p><br></p><p><strong><span style="font-size: 14pt;">Showing/Hiding Article Details</span></strong></p><p>In Configuration > Self Service Portal > Knowledge Base Settings, you can find options to choose which details of an article are shown. Visibility of the creation, tag and edit information is split out to enable you to truly customise what your users can see.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjliZTk3YTJhLWUzOGQtNDIxNi1hM2ViLTI1ZWZjOTA4OTFhNyJ9.ipYaHRNjVNePZGYW6FE-yWpQMxdFi1Ad0UqYZWO3LA4" class="fr-fic fr-fil fr-dib" width="224" height="391"></p><p><strong><span style="font-size: 10pt;">Fig 15. Hide/show knowledge base information</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Pin the FAQ list to the page</span></strong></p><p>You can enable 'sticky' FAQ lists. When stick FAQ lists are enabled clicking on an FAQ list in the portal, or navigating directly via its URL, will load the related articles directly into the main content area and automatically highlights the corresponding FAQ list in the sidebar. It also ensures the FAQ list menu says pinned to the screen as you scroll through an article, rather than needing to scroll back to the top of the page to change the FAQ list. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRmYzg5MDMxLWQ4YmYtNDM0MC04YmY1LWI4YTFjZTA2OGZkNSJ9.BxXasoyra4OYlzDJ3El6G5DJcoNGqskNzH7ajBdi3ME" class="fr-fic fr-fil fr-dib" width="1138" style="width: 1140px; height: 571.185px;" height="571"></p><p><strong><span style="font-size: 10pt;">Fig 16. Knowledge base when stick FAQ lists enabled</span></strong></p><p><br></p><p>To enable this, head to Configuration > Knowledge Base, and enable "Enable sticky FAQ navigation menu on the portal". </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRmNWM1ZDQ3LWY4YTgtNDJmMS04OGRiLWM4Y2VlN2NjN2RjNSJ9.5pD_cPNjNDS0itS_h3NX7aXvraZPIrx7cfwQo8zy_G0" class="fr-fic fr-fil fr-dib" width="798" style="width: 800px; height: 292.705px;" height="293"></p><p><strong><span style="font-size: 10pt;">Fig 17. Enable Sticky FAQ lists</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Allow Users to leave Feedback on Articles</span></strong></p><p><span style="font-size: 11pt;">Voting can be enabled for knowledge base articles to allow users to leave feedback on articles. This includes single click voting and prompting users to complete a form, which logs a ticket. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">For more information on this, checkout: <a target="_blank" rel="noopener noreferrer" data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/2666" data-pasted="true" style="font-size: 11pt;">Knowledge Base Article Feedback</a>.</span></p></body>
