Multilingual knowledge base

Multilingual knowledge base is a Premium feature.

Upgrade today to take your documentation to the next level!


BasePress is compatible with WPML making it the perfect solution for a multilingual knowledge base.
This article explains how to use BasePress in conjunction with WPML to make your knowledge base multilingual. It does not cover all aspects of how to use WPML. Please consider visiting WPML website to consult their documentation for further details.

To build your multilingual knowledge base you need to install the following plugins:

  • BasePress (version 1.5.0 or above)
  • WPML Multilingual CMS
  • WPML String Translation add-on
  • WPML Translation Management add-on

After you have installed and activated all plugins and add-ons you are ready to start translating your content.

Introduction to the multilingual knowledge base

When using WPML to translate your knowledge base we suggest to always create your content in the main language and then proceed with the translations. If for example you have English and French as active languages for your website and you have set English as the main language, you should always create content in English first and then translate it to French. This will simplify the process in particular for big size knowledge bases.

Knowledge Base Hierarchy


All content in the knowledge base is hierarchical – Knowledge Bases are top level categories, sections are descendant of Knowledge Bases (or other sections) and finally the articles are descendant of sections. It is very important to preserve this hierarchy during translation.

Always start by translating your Knowledge Bases, then translate the top sections followed by their sub-sections and finally translate the articles. Following this simple order will guaranty that the content hierarchy is always preserved.

How to translate Knowledge Bases and Sections

To translate you Knowledge Bases and Sections go to WPML >Taxonomy Translation and select ‘Knowledge Base Categories’ from the menu.


A list of all Knowledge Bases and sections will appear. In the column with the language flags click the plus icon to translate the item. Fill in the form that will open with the translated content and save. BasePress will keep all data like the KB image, section image and icon, KB and section order for all languages synchronized.
Once the Knowledge Bases and sections are translated you can find the translation in under Knowledge Base >Manage KBs and Knowledge Base >Sections for their relative languages. You can make any further changes directly there without the need to go back to the WPML screen.

How to translate the articles

After you have translated the Knowledge Bases and Sections you can start translating your articles. Go to Knowledge Base >All Articles and click on the plus icon for the language you want to make the translation for.

Translate article
Translate article


The standard WordPress editor will open. You can then proceed creating the translation. Remember to select the Knowledge Base and Section for the translation and save. BasePress will synchronize all extra data like the icon and the article order across all languages.

How to know if some of your content has lost the hierarchy

Knowledge Bases are top level categories for the knowledge base, they will never loose hierarchy so you should not worry about them. Just make sure they are the first to be translated.

Sections and sub sections are child categories of Knowledge Bases. If you translate a section but its parent Knowledge Base has not been translated yet, that translated section will remain without parent. The same will happen if you translate a sub-section before its parent section. Any section or sub-section without parent will be be treated as a Knowledge Base by BasePress.

When this happens you will notice that when you go to Knowledge Base >Manage KBs, the section you have translated will appear in the Knowledge Base list.

To fix a section that has lost hierarchy start by translating its parent Knowledge Base. Once translated go to Settings >BasePress >General and enable ‘Restore Category Screen’.


Restore WordPress category screen
Restore WordPress category screen

You will now find a new menu item under knowledge base called ‘Knowledge Base Categories’. This is the standard WordPress screen to manage categories. Select the section that has lost the hierarchy from the category list and use the parent list to select the correct Knowledge Base for this section and save. You can now disable the Category screen from the options.

Category editor
Category editor

When you are translating an article you won’t be able to select the Knowledge Base or section if they aren’t translated yet. You can save the article as a draft and proceed to translating the Knowledge Base and section the article belongs to. Once finished you can go back to the article, select the Knowledge Base and section and publish the article.

How to translate the setting texts

Some of the text that appear in the front side of the knowledge base are present under Settings >BasePress. To translate them go to WPML >String Translation and select ‘admin_texts_basepress_settings’ from ‘Select strings within domain’ menu. You will get a list of all BasePress settings. Click on ‘translations’ on the right side of each item, add your translation and save.

BasePress settings translation
BasePress Settings – Translation

How to translate the widgets

To translate the widgets go to WPML >String Translation and select ‘Widgets’ from ‘Select strings within domain’ menu. You will get a list of all active widgets including the the ones for the knowledge base. Click on ‘translations’ on the right side of each item, add your translation and save.


Was this helpful?

Previous Article