<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><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;
}
</style><p><span style="font-size: 14px;"><strong>In this guide we will cover:</strong></span></p><p><span style="font-size: 14px;"><strong>- Changing Language per Agent</strong></span></p><p><span style="font-size: 14px;"><strong>- Setting a Default Language</strong></span></p><p><span style="font-size: 14px;"><strong>- Customise Language</strong></span></p><p><span style="font-size: 14px;"><strong>- Add Translations Shortcut</strong></span></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/1869/" target="_blank" rel="noopener noreferrer"><strong>Language</strong></a></li></ul><p><br></p><p><span style="font-size: 18px;"><strong>Changing Language per Agent</strong></span></p><p><span style="font-size: 14px;">You can change your own language under your agent profile. Go to the top right corner and click your profile picture > My Account > Preferences tab > Usability dropdown > "Application Language". This will be set to the global setting by default but can be changed.</span></p><p><br></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAyYWEwNmYyLTZmZjQtNDgzNy04NzhiLWMzMjhhMzViYjQxOSJ9.n7lwdtP0lHvS3efscQtMlkQjkhkNOXOWjdTqK5Rx2bo" class="fr-fic fr-fil fr-dib" width="673" height="591"></span></p><p><span style="font-size: 10pt;"><strong>Fig 1. Changing the language of an agent.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 18px;"><strong>Setting a Default Language</strong></span></p><p>In Configuration, you will find the Language module in the Advanced section.</p><p><br></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjZTcxZWQxLWI5ZTctNDAwYy1hNjYxLTYyYjZjNDY4NjAwMiJ9.aGaAVDsGzd6DsVRSfdqIjoRD9ZRwa7zIPZlCOOhXQ6M" class="fr-fic fr-fil fr-dib" width="688" height="198"></span></p><p><span style="font-size: 10pt;"><strong>Fig 2. Language module.</strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">Clicking into this will show the below screen, where you will see an option to set the default language, customise any language used and allow users to select a language.</span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRmNmZmNzYwLTE0NGYtNGI1My05ZjZmLWNkMGZjOTczNmFhOCJ9.YwPeBY9O7GV5lplnam6H7FayI1XUDzOD083ZXTpU9Vg" class="fr-fic fr-fil fr-dib" width="1236" style="width: 1238px; height: 583.158px;" height="583"></span></p><p><span style="font-size: 10pt;"><strong>Fig 3. Setting default language.<br></strong></span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 18px;"><strong>Customise Language</strong></span></p><p><span style="font-size: 14px;">Clicking into the "Customise Language" button will bring up the list of languages currently imported into your Database.</span></p><p><br></p><p>The following screen will then show. Here you have the option to import/export the language pack to edit it in bulk, or add custom translations.</p><p><br></p><p id="isPasted"><span style="font-size: 14px;">If you have an updated language pack from us or one of our previous software packages you can import from or export to this using the first two fields.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFmZjFhMWU3LTUzZTgtNDIzYy1hZDA1LWJhZDE0ZGEwOTZmOSJ9.K2etuO6q5L7D3pEhrYXUIuTALill16LE-pLVkEiOBlk" width="1238" style="width: 1240px; height: 582.503px;" height="583" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 4. Import/Export options on a language pack.</span></strong></p><p><br></p><p>Clicking "Export Custom Translations" will provide an Excel file of what each term is called, like below. This can be edited and then reimported to edit how each term is called.</p><p><br></p><p>This will show entities that have been custom named by yourself instead of hard-coded into Halo.</p><p><br></p><p>i.e. "Service" is preconfigured, but the service type like "Laptop Request" is custom.</p><p><br><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU3NzQxZjA1LTVlY2YtNGQyMi05Yjk4LThkMTNlNWFiZjZlNiJ9.xuKXAcSOCDgnDyw6wBVxHm9LmVWcTnQnKWDW-W3g_1w" width="762" height="87" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 5. Section of the export file.</span></strong></p><p><br></p><p>In the following tabs, you can then edit the phrasing of the pre-configured areas by editing the language pack.</p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">To translate a phrase/term in your Halo you will need to find this in the language pack. Terms are separated in to separate tabs depending on where/how they appear. You can either search using the "Description" column, this is the description of where the term is found. Or, you can search using the "Default Value" column, this is the visible term without any translation. The "Translated String" column is the string that the default value will be translated into when using this language pack. </span></p><p><br></p><p>If I change "Tickets" to "Calls"...</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhjOGRhNTBhLTUwZGItNDc4Yi1hNDI2LTgzNGViNTg5YzhkMiJ9.jb-CYPw5nakNM7l_HUR_ARA8jO_ICuXRbxZjqul_HmY" width="1234" style="width: 1236px; height: 579.597px;" height="580" class="fr-fic fr-dii"></p><p><strong><span style="font-size: 10pt;">Fig 6. Changing the language pack.</span></strong></p><p><br></p><p>You can see where the word "Tickets" appears, it now says "Calls" instead.</p><p><em><strong>Note: If changed with this method, the word will change anywhere it appears - you cannot specify this to a certain area.</strong></em></p><p><br></p><p><em><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg2NGJkYjkwLWFiZjYtNGEwMi05ZDMxLTkxMTM1N2NlYzdkNCJ9.04slf8lEugkhXe9rnAVA2WMNBWYQwGJ6C4K5AhqCt_U" width="566" height="190" class="fr-fic fr-dii"></strong></em></p><p><strong><span style="font-size: 10pt;">Fig 7. Tickets configuration changed with the language pack.</span></strong></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;">If you notice some phrases are not translated in the language pack, for example a custom field label, this will be due to the translated string not being present in the language pack. Once a string is added, this will be translated. </span></p><p><span style="font-size: 14px;"><br></span></p><p><span style="font-size: 14px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBmODc3N2ZlLTYyZmUtNGM3Ni1hYzE0LTRlYjFkZGJhODdkZSJ9.8sPL4QJlmx4N1o3LMAwoJ01cGlpkmBNXJ4PumyA8L6o" class="fr-fic fr-fil fr-dib" width="1232" style="width: 1234px; height: 579.986px;" height="580"></span></p><p><span style="font-size: 10pt;"><strong>Fig 8. Field label without a translated string.</strong></span></p><p><br></p><p><span style="font-size: 18px;"><strong>Add Translations Shortcut</strong></span></p><p>Some field labels will have an 'Add translations' shortcut next to them when being created/edited. </p><p><br></p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2ZDEzMzgzLWE4MmEtNDRmZi1iZjczLWMwMGE0NThiYTFiMyJ9.ZdziegrYVsIa-1ONR8rGjFX6s5VtiooML3wI5XbAnAg" class="fr-fic fr-fil fr-dib" width="830" style="width: 832px; height: 150.35px;" height="150"></strong></p><p><strong><span style="font-size: 10pt;">Fig 9. Add Translations shortcut against field.</span></strong></p><p><br></p><p>This shortcut allows you to quickly add a translation for the string in this field to a language pack(s) of your choice, without needing to navigate to the language pack configuration. It is important to note that any fields that have this shortcut against them do not appear in the language pack, a translation for them must be added using the shortcut. Entities that have this shortcut include but are not limited to:</p><p><br></p><ul><li>Service name.</li><li>Dashboard widget title.</li><li>Self-service portal button title and description override.</li></ul><p><br></p><p>If you cannot find a field in the language pack it likely uses the "Add translations" shortcut instead. </p><p><br></p>
