<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 id="isPasted"><strong>In this guide we will cover:</strong></p><p><strong>- Navigating to the Knowledge Base</strong></p><p><strong>- Searching for Articles</strong></p><p><strong>- Creating an Article</strong></p><p><strong>- Updating Articles</strong></p><p><strong>- Sending Article Links</strong></p><p><br></p><p><br></p><p><strong>Admin Guides:</strong></p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1844" target="_blank" rel="noopener noreferrer"><strong>Knowledge Base</strong></a></li></ul><p><br></p><p><strong>Related Guides</strong></p><ul><li><strong><a href="https://usehalo.com/haloitsm/guides/2047" target="_blank" rel="noopener noreferrer">Article Drafts</a></strong></li><li><a href="https://usehalo.com/haloitsm/guides/2043" target="_blank" rel="noopener noreferrer"><strong>FAQ Lists in the Knowledge Base</strong></a> </li><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/2486/" target="_blank" rel="noopener noreferrer"><strong>Knowledge Base Articles in the User Portal</strong></a> </li><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1999/" target="_blank" rel="noopener noreferrer">Providing Access to your Knowledge Base</a></li></ul><p><br></p><p>This guide will cover the basics of creating and editing articles, and navigating the area.</p><p><br></p><p><strong><span style="font-size: 14pt;">Navigating to the Knowledge Base</span></strong></p><p>If not already, the knowledge base can be enabled in Configuration > Optional Features. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE5ODhkNjhjLTFmMmUtNDkxNy04Njg3LWNkZWM3Y2JjZWI1OCJ9.Q4Ozu8hCCS3xD5heqrEh7IE3KvVLpO377AK2KeDrnFw" width="105" height="126" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the Knowledge Base module</span></strong></p><p><br></p><p>The module can then be found either in the module bar, or in the overflow, depending on the navigation menu format you are using.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZmM2RiNDhjLTMzZmYtNGEwZC1hNmUxLTRiMTliM2U4Y2FlNiJ9.O8bSffragMZdD-Q0BsbdrnMNpy0tZH2RqJyKM0vHd3M" width="197" height="53" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 2. Knowledge Base module in the module bar</span></strong></p><p><br></p><p>Clicking into the module will bring up the knowledge base area. This will provide an overview of the FAQ lists on the left hand side, as well as a list of the most upvoted articles on the right. Here you can also see the "New Article" and "All Articles" buttons.</p><p><br></p><p>The "All Articles" button can be clicked to bring up a list of articles with the date created, name, description, the FAQ lists it is on, tags, next review date and whether it is inactive.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVhNTMyMWRhLTMxODEtNDI1NC04MThkLWJlN2FmYmVjYjg3YiJ9.66P1T1pPJAY-ymuL641lowtvNx-1jn1iiypSvxiXYKU" width="1215" style="width: 1217px; height: 589.229px;" height="589" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 3. Knowledge base screen</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Searching for Articles</span></strong></p><p id="isPasted">At the top left of the screen, there is also a search bar to search for articles. Searching here will show the below screen where you can filter results on the left side, or select how to sort the results on the right above the first result. </p><p><br></p><p>You can see the name and description of each article and the number or views/upvotes they have.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTM4NjQ2LTk1MWYtNDcwMS04ZDk1LTVhY2RmNWY3YjI3ZCJ9.INNQTDi7MktLX20c-jgjg-lEHoXkG9Y9cTNB6vSWVK8" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 572.039px;" height="572"></p><p><strong><span style="font-size: 10pt;">Fig 4. KB search screen</span></strong></p><p><br></p><p data-pasted="true">To optimize this search, "Enable Knowledge Base Article Full-Text Searching" can be switched on in Configuration > Advanced Settings > Searching. Full text searching searches for the entire string, rather than each individual word within the string, which not only speeds up searching, it also makes it more accurate upon doing so. This functionality will return search results which contain the whole, unbroken search phrase higher than articles which otherwise match the search phrase when using the search type "Search for each word of the search string" or "Search for every word of the search string". From v2.242+, If you are using Full-Text searching you will have the option to determine whether to include the Internal Memo in Agent search results using the checkbox "Full-text search the internal memo field when an Agent is searching".</p><p><br></p><p>Within Configuration > Knowledge Base you can further adjust the behaviour of your search. The "Knowledge Base Search Type" drop-down can be used to determine if the search results will include only articles which contain the entire string, articles with contain any part of the string, or articles containing every word within the string. You will also be able to choose the behaviour for searching IDs. To do this you can set the "Article ID Search Behaviour" to prevent the searching of Article IDs, only return the Article with the ID searched, or include both the searched ID and other results. </p><p><br></p><p><strong><em>Note: You can surround the phrase you are searching for is quotation marks (" ") to search for the exact content.</em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Creating an Article</span></strong></p><p>Click the "New Articles" button on the main to bring up the screen to create an article. You will see the below fields to enter information, a summary of the base ones is as follows:</p><p><br></p><ul><li><strong>"Title"</strong> - The title of your article.</li><li><strong>"Article Type"</strong> - If using both knowledge base and news articles, you can specify which of the two here.</li><li><strong>"Description"</strong> - A short description of the contents of the article, or of the problem. This will show on the screen underneath the title when viewing a list.</li><li><strong>"Resolution" </strong>- The main body of the article, or a summary of how to solve the problem.</li><li><strong>"Internal Memo"</strong> - An area to put private notes that agents can see, but not end-users.</li><li><strong>"Attachments"</strong> - Add attachments to your article here.</li><li><strong>"Tags"</strong> - Short words or phrases that users can search by to easily find an article.</li><li><strong>"Related Articles"</strong> - Articles that may have similar contents or be otherwise related. They will show linked at the bottom of the article once published.</li><li><strong>"Teams that can access this article"</strong> - This can be used to restrict which teams can view the article. By default, this will show "All Teams".</li><li><strong>"FAQ Lists that this article appears on"</strong> - A multi-select field with what FAQ lists an article is contained on.</li><li><strong>"Active"</strong> - When enabled, the article can be found in FAQ lists and search.</li><li><strong>"Next Review Date"</strong> - The date set that the contents of an article should be reviewed by, and then amended if considered obsolete. </li></ul><p><br></p><p>Article access can also be restricted here. For more information on this, check out the "<a href="https://usehalo.com/haloitsm/guides/2044" target="_blank" rel="noopener noreferrer"><strong>Article Restrictions</strong></a>" guide.</p><p><br></p><p>When using the description or resolution fields, there is also a toolbar across the top of the text box where you can format the text, embed pictures, videos and links, create tables, or switch to code view to edit the HTML.</p><p><br></p><p>A "Paragraph Formatter" option is available in the toolbar. This will show each header type/formatting, allowing you to easily insert header HTML into the article.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZmM2JkZWQ4LWQ0YWEtNGJhMy04ZDE0LWE5ZDc3ZjhiNzZjMSJ9.58NwjKp1Dxi9Lr5Rqk0xOCPgJwgLe8ZW7ej7x9XG2uQ" width="1214" style="width: 1216px; height: 730.55px;" height="731" class="fr-fic fr-dii"></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4MTU1ODdiLTNiNDAtNGNiOS1hZWI5LTRhZDRkMTQwOWRmOCJ9.6f5UnagOAStEcRIkULOPsRzZkauZxZzhFRAcqpC-G2o" width="1212" style="width: 1214px; height: 604.634px;" height="605" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 5. Creating an article</span></strong></p><p><br></p><p>After entering the required details, scroll to the bottom and press "Save". Your article will now be created, and appear like below.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ5NmE3N2FkLTUwMWYtNGRlOS1iYWUyLTk1Yjc2MDdkNjZiNyJ9.EvDxNZAEsQXxxoilLWKkJcOqq9B5vFQgbSgWNyAN1ig" width="1218" style="width: 1220px; height: 689.319px;" height="689" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 6. Created article</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Updating Articles</span></strong></p><p>Upon creation, the following buttons will appear at the top of the article.</p><p><br></p><ul><li>"Edit" - Brings up the edit screen which looks the same as the creation screen, and allows the agent to make changes to the article. The agent that edits the article will then appear underneath the "Created by" with a new line saying "Edited by". If another agent edits afterwards, the most recent agent will show here.</li><li>"Clone" - Bring up a popup screen to name the new article. Upon naming and saving, another identical copy of the article will be saved with the new name. Agents can then edit the article as normal.</li><li>"Generate PDF" - This will create a PDF of the article with the default template.</li><li>"Send" - This will email out a PDF of the article with the default template.</li><li>"Delete" - This will delete the article.</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg4NTMxMjBmLTUyZTItNDY0ZS04YzM3LTI1ZGJlNWI1ODE1MCJ9.nErFh7kTDl2HAu3KV8l9rv80rNgs1jVeSN6_irQaPHw" width="493" height="45" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 7. System actions after creating an article</span></strong></p><p><br></p><p>You can allow bulk editing of tags and FAQ lists associated with articles. In Configuration > Knowledge Base > Articles, you can enable the below checkbox.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdjNGE0N2VjLTM2MTMtNDQ3ZC1hMDRkLTRlNjQ1MTkzYmNkZiJ9.BlgojuZARCpB47C1jEb7vGEs-b0nObB6gkLSJ3tS3Z4" width="492" height="33" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 8. Allow Agents with edit permissions to bulk edit Articles in the 'All Articles' view.</span></strong></p><p><br></p><p>When clicking the "All Articles" button, agents will see a checkbox next to each article in the list. Upon selecting one or more, an "Edit" button will show in the top left corner. Hovering over this will show the options to edit either tags or FAQ lists.</p><p><br></p><p>"Add Tags" and "Add to FAQ Lists" will add an additional one to the existing list, whereas "Set Tags" and "Set FAQ Lists" will override the existing ones and delete any that are not selected here, and you can set a "Next Review Date".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEyZTU1ZGI1LTRhY2MtNGMyYS1iMzlhLWQ4NjM2M2YzZDMxMiJ9.KGDRghquvPtefRJhnvHW7fpoKMAw80Qn_3uMKzpEF9w" class="fr-fic fr-fil fr-dib" width="230" height="248"></p><p><strong><span style="font-size: 10pt;">Fig 9. Bulk editing an article</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Enable Collision Detection</span></strong></p><p><span style="font-size: 11pt;">You can enable collision detection for article editing. This will alert an agent if another agent is viewing/editing the same article as them. Helpful in preventing agents editing the same article at the same time. </span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">To enable this head to Configuration > Knowledge Base > "Enable collision detection for when multiple Agents are editing the same Article". </span></p><p><strong><span style="font-size: 10pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhjOTVjNDUyLTA2YTYtNDZmNC05OWNkLTZlZWNmMGNmN2E1MyJ9._vZvp9wOPT-JJYPQZOzj1Jr2lY9rOfExM0rUx5DKnIY" class="fr-fic fr-fil fr-dib" width="563" style="width: 565px; height: 278.406px;" height="278"></span></strong></p><p><strong><span style="font-size: 10pt;">Fig 10. Enable collision detection</span></strong></p><p><strong><br></strong></p><p data-pasted="true">If two agents are viewing/editing an article at the same time they will see the pop-up shown in figure 11. </p><p><strong style="background-color: transparent; font-size: 13px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZlODI5Yjk1LWFmMDItNDVhNi04OGYwLWFlZGVjYWEwYTJkOSJ9.oOlJf-QHlC1efQfJhHT_YlGaIObtltmP2UhFtTivH5M" class="fr-fic fr-fil fr-dib" width="1508" style="width: 1510px; height: 743.359px;" height="743"></strong></p><p><strong><span style="font-size: 10pt;">Fig 11. Pop-up for article collision detection</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sending Article Links</span></strong></p><p>You can quickly copy a link to an Article, using either the Agent or User portal URL. Hover over the share icon and select an option. If Article Versioning is enabled in Configuration > Knowledge Base, you will have additional options to send the latest version.</p><p><br></p><p>The latest version links will use unique identifiers as part of the URL. The view counts of each version of an article will then be totalled together.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0YzkxMzhmLWI3ZjAtNDk2Mi1hY2JhLTNjNTI4ZGVjZjNhZCJ9.34-juVGLNDID9phsGU8VJ6pX-WFxxL5F7hlYfUteSrM" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 306.55px;" height="307"></p><p><strong><span style="font-size: 10pt;">Fig 10. Share link options</span></strong></p><p><br></p>
