Change a Knowledge Base Source Locale - HL Vanilla Community
<main> <article class="userContent"> <p>Every Vanilla knowledge base (<strong>KB</strong>) has a <em>default language</em>; this is called its <strong>Source Locale</strong>. All categories and articles in a KB will display in the language that is set by the Source Locale.</p><p>This article describes how to change a ("target") KB's Source Locale.</p><p>🛑 <strong>IMPORTANT</strong>: Read this article <strong>BEFORE</strong> you change a KB's Source Locale.</p><p>🛑 <strong>WARNING</strong>: Generally, Vanilla does not recommend changing a KB's Source Locale as it could result in articles "disappearing."</p><h2 data-id="prep-the-kb">Prep the KB</h2><p>Prior to changing the Source Locale of a KB, make the following changes in that target KB.</p><h3 data-id="kb-properties">KB properties</h3><ol><li>In the Dashboard, navigate to <strong>Settings > Knowledge > Knowledge Bases</strong>.</li><li>Click the <strong>pencil</strong> icon of the target KB to edit it.</li><li>Change (i.e., translate) the <strong>Title</strong> and <strong>Description</strong> of the KB into the language of the intended Source Locale.</li><li>Click <strong>Save</strong>.</li></ol><h3 data-id="kb-categories">KB categories</h3><ol><li>In the target KB, open any article.</li><li>In the left sidebar, click <strong>Organize Categories</strong>.</li><li>On the Organize Categories page, click the name of a Category and click <strong>Rename</strong>.</li><li>Specify the new (i.e., translated) name for the Category and click <strong>Apply</strong>.</li><li>Repeat these steps for all Categories that have to be translated into the language of the intended Source Locale.</li></ol><h3 data-id="kb-articles">KB articles</h3><p>All articles in the target KB have to be translated into the language of the intended Source Locale <em>before</em> you change the Source Locale.</p><p>🛑 <strong>WARNING</strong>: Articles that are not translated might be orphaned.</p><p>To learn how to <em>translate KB articles</em>, see:</p><div class="js-embed embedResponsive" data-embedjson="{"body":"📝 NOTE: This feature requires that the Product Integration option be enabled. Prep - link subcommunities to knowledge bases Knowledge bases (KBs) can be linked to subcommunities through a shared product. In order to do so, you have to: enable the Product Integration setting, link a subcommunity to a product, and select the…","photoUrl":"https:\/\/us.v-cdn.net\/6030677\/uploads\/VWGAXAF5OFCO\/microsoftteams-image.png","url":"https:\/\/success.vanillaforums.com\/kb\/articles\/431","embedType":"link","name":"Translating Knowledge Base Articles - Vanilla Success"}"> <a href="https://success.vanillaforums.com/kb/articles/431" rel="nofollow noreferrer ugc"> https://success.vanillaforums.com/kb/articles/431 </a> </div><h2 data-id="change-a-kb's-source-locale">Change a KB's Source Locale</h2><p>📝 <strong>NOTE</strong>: Before proceeding with the process detailed in this section, make sure you have read the sections above. <em>Failure to do so could result in the loss of content</em>.</p><p>Changing a KB's Source Locale could have unforeseen consequences, especially if done incorrectly or incompletely.</p><ul><li>Make sure this process is necessary before starting.</li><li>Reach out to your CSM or Vanilla support (<a href="unsafe:support@vanillaforums.com" rel="nofollow noreferrer ugc">support@vanillaforums.com</a>) if you have any questions.</li></ul><p>To change a Source Locale:</p><p>1. In the Dashboard, navigate to <strong>Settings > Knowledge > Knowledge Bases</strong>.</p><p>2. Click the <strong>pencil</strong> icon of the target KB to edit it.</p><p>3. On the edit modal, click the <strong>Locale</strong> dropdown and choose a language.</p><p>✔️ <strong>TIP</strong>: If the language you want isn't listed, refer to <strong><em>Add languages for Source Locale</em></strong>, below, for information on how to add languages.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/CMPQ8ULKGEAN/change-source-locale.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/CMPQ8ULKGEAN/change-source-locale.png" alt="Change Source Locale.png" height="530" width="1012" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>4. Click <strong>Save</strong>.</p><h2 data-id="add-languages-for-source-locale">Add languages for Source Locale</h2><p>If the language that you want is not available in the <strong>Locale</strong> list, check the Language Settings page to see whether it's available and enabled.</p><p>1. Navigate to <strong>Settings > Technical > Language Settings</strong>.</p><p>2. Scroll through the list to the language you want and make sure that it is enabled.</p><p>✔️ <strong>TIP</strong>: In the following image, Bahasa Melayu is <strong>not enabled</strong>; Catalan <strong>is enabled</strong> (the toggle is to the right).</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6030677/uploads/25WP767J0VVG/change-source-locale-language-settings.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6030677/uploads/25WP767J0VVG/change-source-locale-language-settings.png" alt="Change Source Locale-language settings.png" height="440" width="722" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>📝 <strong>NOTE</strong>: When you enable a language it is immediately available in the <strong>Locale</strong> dropdown list.</p><h2 data-id="appendix-a%3A-supported-languages">Appendix A: supported languages</h2><p>Vanilla supports a number of languages.</p><ul><li>Click to see a <a href="https://www.transifex.com/projects/p/vanilla/" rel="nofollow noreferrer ugc">list of supported languages</a>.</li></ul><p><br></p> </article> </main>