Translating KB Articles - Vanilla Success
<main> <article class="userContent"> <h2 data-id="subcommunities-knowledge-base">Subcommunities & Knowledge Base</h2><p><em>This feature requires the Product Integration to be enabled.</em></p><p>Knowledge bases can now be assigned to subcommunities through a shared product. After enabling products and linking subcommunities to them you will find a "Product" dropdown menu in the knowledge base add/edit form.</p><p>This can be used to link a product. That knowledge base will then be available in all languages, and all subcommunities of that product.</p><p>Knowledge Base users can also use Machine Translation services to translate KB articles.</p><p>In order to use this feature, you will need to have Subcommunities, the multilingual addon, as well as Knowledge Base enabled. Additionally you will need to be subscribed to one of our available service providers - Google Translate or DeepL Translator.</p><p> </p><h2 data-id="what-does-this-process-do"><strong>What Does This Process Do?</strong></h2><p>It allows you to add and edit translations for each KB article. Additionally it will add a drop down language selector on every translated KB article:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/2XFskjUsorcVdT7adm646-FVz3k_NOBfK31YPrGogwEnhO1g6RZF7XMISjbcp2UXOGue5rSCfnRMg2zJvHeZos7R68XToERD92uldpW3bBTwxILss743_lm6C5PynT7PbA-YcozU=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/2XFskjUsorcVdT7adm646-FVz3k_NOBfK31YPrGogwEnhO1g6RZF7XMISjbcp2UXOGue5rSCfnRMg2zJvHeZos7R68XToERD92uldpW3bBTwxILss743_lm6C5PynT7PbA-YcozU=s1600" alt="2XFskjUsorcVdT7adm646-FVz3k_NOBfK31YPrGogwEnhO1g6RZF7XMISjbcp2UXOGue5rSCfnRMg2zJvHeZos7R68XToERD92uldpW3bBTwxILss743_lm6C5PynT7PbA-YcozU=s1600" height="268" width="314" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p> </p><p>Your KB will have the same number of entries as before, following the same organization structure in each language, it will just serve up different content, depending on which subcommunity is being viewed. This allows each translation of an article to have the same post ID as the original article - which is important for maintaining the organization of multiple subcommunities.</p><p>Another way of explaining this process is that it creates <strong>one </strong>KB that lives in <strong>one </strong>spot, has <strong>one </strong>set of articles, has <strong>one </strong>layout and structure, but speaks multiple languages - depending on who's talking to it.</p><p>It is possible to use this process with machine translation, or with client-provided translations.</p><h2 data-id="what-does-this-process-not-do"><strong>What Does This Process Not Do?</strong></h2><p>This process does not allow you to connect a KB written in one language to an existing, separate KB written in a different language.</p><p> </p><h2 data-id="how-to-set-up-a-kb-for-translation"><strong>How To Set Up a KB For Translation</strong></h2><p>1. Navigate to the “Language Settings” section of your dashboard and turn on locales for each language you want to translate your KB into:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/OgZjifrQ1mc-s90LWkCDE-2syzhUwi5k--95Pzcp869YDUXy4D4V1yBSjrLGR8OT0_R2dn0ZLfenfNhuRF_82HEp7pmiIr18n4c6hn46FLeTeOd3siV3E-Ax0ke32pKWH6r9Cpe3=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/OgZjifrQ1mc-s90LWkCDE-2syzhUwi5k--95Pzcp869YDUXy4D4V1yBSjrLGR8OT0_R2dn0ZLfenfNhuRF_82HEp7pmiIr18n4c6hn46FLeTeOd3siV3E-Ax0ke32pKWH6r9Cpe3=s1600" alt="image01.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>2. Under Subcommunities turn on "Enable Product Integration" and add a product to represent the translation. In the example below we’ve called the product “Translation” for simplicity:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/WRgMcBrpGQkSFV-4GdZBU0G6SKZ8ObGsQUspk1gQ9vNnpPh0rR7h-78B-_PYdS80cQS_7AGE8hFhKe9MB6l55NWXy9gByBkeDoi0CpZwIin7hw-X4GW6mXgB5UkhZLxuHF8pF3bJ=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/WRgMcBrpGQkSFV-4GdZBU0G6SKZ8ObGsQUspk1gQ9vNnpPh0rR7h-78B-_PYdS80cQS_7AGE8hFhKe9MB6l55NWXy9gByBkeDoi0CpZwIin7hw-X4GW6mXgB5UkhZLxuHF8pF3bJ=s1600" alt="image02.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>3. Set up a subcommunity for each language. Make sure to set the Product field to the product you just created (“Translation”)! Every subcommunity that you want a translation for should use the <strong>same </strong>product.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/mNjeGfs9s6znWBTf0kUEqOI-T4giWqynaGYZcJdSsy07Z7dC4-8FFnxLtMzBVi-ljTzgyLj3bVTBEJ_1eKGwy3fN4S_exNtS1R9NEyYvweiFA6h7nQsL8CEq_BiT1lWC4-sACzqP=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/mNjeGfs9s6znWBTf0kUEqOI-T4giWqynaGYZcJdSsy07Z7dC4-8FFnxLtMzBVi-ljTzgyLj3bVTBEJ_1eKGwy3fN4S_exNtS1R9NEyYvweiFA6h7nQsL8CEq_BiT1lWC4-sACzqP=s1600" alt="image03.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>4. Add the “Translation” product to the Knowledge Base you want to translate. You can do this for any number of KBs, just remember that you will only need to create the content (KB / articles) once and add the translations to that original content.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh4.googleusercontent.com/9G41_fS5L7ZSfq7YS6F6sDV85ijHeYMNfAxr7ZHNZ-mXllptNssZILUZuMNeiGL6_RqSsqC6JGSFMSpRQBUXV8IJN1surWfBG91a-jcIEyTobAakdhAi9ooy5lM0utaQAVCoG_EA=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh4.googleusercontent.com/9G41_fS5L7ZSfq7YS6F6sDV85ijHeYMNfAxr7ZHNZ-mXllptNssZILUZuMNeiGL6_RqSsqC6JGSFMSpRQBUXV8IJN1surWfBG91a-jcIEyTobAakdhAi9ooy5lM0utaQAVCoG_EA=s1600" alt="image04.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>5. Click the translate button on the KB settings window to translate the KB titles for each locale.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/JVPZQvjSPHkJTe7qxHRGia5QHptIFkdJc2TipLBD2jXvHAfrzAi8aVKG5NKWAyebdSrrl-iT8peKB7XIaKAZL7QDGjRU7CrPEb14EStvLvrP_toKqtfXEfvxzw3Bd5R9wGZ8vlVv=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/JVPZQvjSPHkJTe7qxHRGia5QHptIFkdJc2TipLBD2jXvHAfrzAi8aVKG5NKWAyebdSrrl-iT8peKB7XIaKAZL7QDGjRU7CrPEb14EStvLvrP_toKqtfXEfvxzw3Bd5R9wGZ8vlVv=s1600" alt="image05.png" height="351" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>6. Provide translations for each KB article. Translations can be added manually or using Machine Translation (with either DeepL or Google Translators):</p><h2 data-id="manual-translation%3A"><strong>Manual Translation:</strong></h2><p>To manually translate an article, start on the article page in the primary language. </p><p>Click on the drop down beneath “Other Languages” and select the language you would like to translate. You will see a red exclamation point beside any languages that are missing the translation (such as “Francais” in the image below:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/L_TZ3IK6Qi0YIy22gBl0fWbUx2eJ00f8m-7LPOICdzSY_LCO9O9hwV_n4CSbXsUdfdjX6eOp7rT4Z1CTyfxdogp24zZhrI20JE3TFjgbbpVlAdYUrUFceIJyD_Q6oFjFAcsrPc4R=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/L_TZ3IK6Qi0YIy22gBl0fWbUx2eJ00f8m-7LPOICdzSY_LCO9O9hwV_n4CSbXsUdfdjX6eOp7rT4Z1CTyfxdogp24zZhrI20JE3TFjgbbpVlAdYUrUFceIJyD_Q6oFjFAcsrPc4R=s1600" alt="L_TZ3IK6Qi0YIy22gBl0fWbUx2eJ00f8m-7LPOICdzSY_LCO9O9hwV_n4CSbXsUdfdjX6eOp7rT4Z1CTyfxdogp24zZhrI20JE3TFjgbbpVlAdYUrUFceIJyD_Q6oFjFAcsrPc4R=s1600" height="245" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p></p><p><br></p><p>You will now be viewing the same article in the new Language subcommunity. You should see a message (in the new language) letting you know how to update this version of the article:</p><p><br></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/Ja-T7v5MIYrcCEE-lRaty6iclhHAwtvOrtKfVuhdf9IBk9l0asvER6hBibaGqkgObNd3rbnH9Z_d3mK1StH30XTqBEbrgVIufVLgaIpSLXjaho0RPmVLMbw2f6clGhiFZwnhlTCD=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/Ja-T7v5MIYrcCEE-lRaty6iclhHAwtvOrtKfVuhdf9IBk9l0asvER6hBibaGqkgObNd3rbnH9Z_d3mK1StH30XTqBEbrgVIufVLgaIpSLXjaho0RPmVLMbw2f6clGhiFZwnhlTCD=s1600" alt="Ja-T7v5MIYrcCEE-lRaty6iclhHAwtvOrtKfVuhdf9IBk9l0asvER6hBibaGqkgObNd3rbnH9Z_d3mK1StH30XTqBEbrgVIufVLgaIpSLXjaho0RPmVLMbw2f6clGhiFZwnhlTCD=s1600" height="75" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>Click on the three dots on the top right corner of the article and select “Edit” (translated version):</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/rfiDVrUvwBehCIkAk1rURjyv03Qtbi3sLaLQNZZ5D_vPRJZfCWW-KgNPQL0ce16jKsBADjrnOvVySH5xg0-hoAjhWNpp5nHv3tEHJU1yLMDm-F-fz9yN1b9HmXR6bbE6FUITfQBp=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/rfiDVrUvwBehCIkAk1rURjyv03Qtbi3sLaLQNZZ5D_vPRJZfCWW-KgNPQL0ce16jKsBADjrnOvVySH5xg0-hoAjhWNpp5nHv3tEHJU1yLMDm-F-fz9yN1b9HmXR6bbE6FUITfQBp=s1600" alt="rfiDVrUvwBehCIkAk1rURjyv03Qtbi3sLaLQNZZ5D_vPRJZfCWW-KgNPQL0ce16jKsBADjrnOvVySH5xg0-hoAjhWNpp5nHv3tEHJU1yLMDm-F-fz9yN1b9HmXR6bbE6FUITfQBp=s1600" height="265" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>Add in the translated version of the article and click Publish.</p><h5 data-id="you-will-now-see-the-translation-of-this-article-linked-to-the-original-language-article.">You will now see the translation of this article linked to the original language article.</h5><h2 data-id="configuring-google-translate"><strong>Configuring Google Translate</strong></h2><p>To configure Machine Translation you will need a Google Translate API key. Once you have this, go to the Machine Translation tab and edit Google Translate, and enter your API key:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/ErU-It2tUOS_IN7xL22XhzhEaoriUgeAFc2xNGIVeZ_hbKSAZkRvfSWkGW_28fpRqsrh2YLdAyq0Cdm3IHUVKPPrbDkDXrURCTSQmBTIpmuwYmA609Ein3GhhrJWrtWGLe4DS7Yy=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/ErU-It2tUOS_IN7xL22XhzhEaoriUgeAFc2xNGIVeZ_hbKSAZkRvfSWkGW_28fpRqsrh2YLdAyq0Cdm3IHUVKPPrbDkDXrURCTSQmBTIpmuwYmA609Ein3GhhrJWrtWGLe4DS7Yy=s1600" alt="Google Translate Configuration" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <h2 data-id="configuring-deepl-translator"><strong>Configuring DeepL Translator</strong></h2><p>To use DeepL, you will need to have a DeepL API Pro account. To enable the optin submit a request to our Support team or via your CSM to have this enabled. Once enabled you can configure this service using your DeepL Translator API Key. DeepL offers more advanced configuration options so you can add:</p><ul><li>Words to ignore while translating</li><li>HTML/XML tags to ignore while translating</li><li>HTML/XML tags to cause splits</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/a0bTEibbqRdzJnGaxe-o1P-TsSmZz324mtxJwvJPZktC7w6GfW6sYdGZuyFI_5KJc3ttF9b7353khaDXEUZTuUXT50pIYA9icQ6GM94S4LbH7BzdCOY6OTsijePATOtJVFLERR95=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/a0bTEibbqRdzJnGaxe-o1P-TsSmZz324mtxJwvJPZktC7w6GfW6sYdGZuyFI_5KJc3ttF9b7353khaDXEUZTuUXT50pIYA9icQ6GM94S4LbH7BzdCOY6OTsijePATOtJVFLERR95=s1600" alt="DeepL Translation Configuration" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>Once you've configured your service provider(s) you then have the option to configure which service to use per language. Go back to the Localization Tab and edit your enabled Language Packs and select the service provider you would like to use. Choose "None" if you do not wish to use Machine Translation for a specific language and you'd like to manually translate your content.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/fBIqAd8HXKGyGBNg8z65iljU6cyPfAddOwGiocJy85IkLbX18oExF7AsCMvU6HLKLMxYdBBITKVSRXofPDi_aECcnUKyO15HEjMs0Xq1r4C9Zrlg7g05P_ezWXrDgx9gBIMq6qQu=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/fBIqAd8HXKGyGBNg8z65iljU6cyPfAddOwGiocJy85IkLbX18oExF7AsCMvU6HLKLMxYdBBITKVSRXofPDi_aECcnUKyO15HEjMs0Xq1r4C9Zrlg7g05P_ezWXrDgx9gBIMq6qQu=s1600" alt="Per Language Service Provider Setting" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="translating-articles"><strong>Translating Articles</strong></h3><p>Now that Machine Translation is set up, you can start translating articles.</p><ul><li>Go to your KB, and find an article you would like to translate.</li><li>In the Options menu, select "Machine Translation" this will launch a modal.</li></ul><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/RUPs0wxhw7igym6mWXM4o2eHDb3ACYlN-xTNtWYu2c281bV1ViGJwBqWXksvUfj5hAUizhPebQfDv_Q_XNM3IjQWLV7kGfS-k_vLj2nlRqYfJIwT3I75CUjyHaZhjdhql4AtFMtc=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/RUPs0wxhw7igym6mWXM4o2eHDb3ACYlN-xTNtWYu2c281bV1ViGJwBqWXksvUfj5hAUizhPebQfDv_Q_XNM3IjQWLV7kGfS-k_vLj2nlRqYfJIwT3I75CUjyHaZhjdhql4AtFMtc=s1600" alt="Machine Translation in Options Menu" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh6.googleusercontent.com/feaOydw8Gj8-3rsCODIWA5GYnNwvUJRxG7d-TfsJFTIE4O_1DZcejJArXT2zWQ-v677WYOTYEyHg81OtWYe52-qksarhupXGCuzryDU5hTfLKQ8LJuZ5ViaRwtThw4ds9pBDOFia=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh6.googleusercontent.com/feaOydw8Gj8-3rsCODIWA5GYnNwvUJRxG7d-TfsJFTIE4O_1DZcejJArXT2zWQ-v677WYOTYEyHg81OtWYe52-qksarhupXGCuzryDU5hTfLKQ8LJuZ5ViaRwtThw4ds9pBDOFia=s1600" alt="Translation Modal" height="180" width="320" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p>The modal will show you all the languages you have configured for this KB, and the articles translation status for each.</p><ul><li>Not Translated indicates the article requires translation to be made available in that language.</li><li>Up to date indicates the article has been translated and is aligned with the source locale</li><li>Out of date indicates the article has been translated in the past, but the source locale has a recent update that may not be reflected in the translation.</li></ul><p>To translate an article that is Not Translated or Out of Date, click the "Translate" action button. Once the article has finished translating it will automatically be published.</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/6x-p745hc4bwU-0-riUc7NKRUL2esMNO8gPTtj6kPNpACxBad4Dwb5kz-CmC8qOjd43qMHarcW209RacvIgJVd_DMK8PKS9owTxknx8djZ-e9T3Dsu_TpTH_lneDPSt0qgd8LHGG=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/6x-p745hc4bwU-0-riUc7NKRUL2esMNO8gPTtj6kPNpACxBad4Dwb5kz-CmC8qOjd43qMHarcW209RacvIgJVd_DMK8PKS9owTxknx8djZ-e9T3Dsu_TpTH_lneDPSt0qgd8LHGG=s1600" alt="Machine Translation Workflow" height="280" width="498" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><p> </p><p><br></p><p> </p><p>Here is an example of a single KB with several translations. It speaks four languages - German, English, French, and Spanish. We don't need to create another KB for those languages, because this one contains them all:</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://lh5.googleusercontent.com/ERI5bIuMFN2GfIbbmZBUs7rjNfCzfqno1Kz6lzaLWVGjv0SKQOxcUdKGAY8_4NE0BGK6J9ZMrBdFLEULepJ1giH3wp9pSb9HMvo8M9JUSluStiWOEHB3_ndrN7e9Df_F9J2MOX9v=s1600" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://lh5.googleusercontent.com/ERI5bIuMFN2GfIbbmZBUs7rjNfCzfqno1Kz6lzaLWVGjv0SKQOxcUdKGAY8_4NE0BGK6J9ZMrBdFLEULepJ1giH3wp9pSb9HMvo8M9JUSluStiWOEHB3_ndrN7e9Df_F9J2MOX9v=s1600" alt="image.png" height="97" width="624" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p> </article> </main>