WP Multilang – Translation and Multilingual Plugin


WP Multilang is a multilingual plugin for WordPress.

Translations of post types, taxonomies, meta fields, options, text fields in miltimedia files, menus, titles and text fields in widgets.

Home | Help & Tech Support | Documentation | Premium Features

New Features of the plugin WP Multilang

  • Support full site editor for block based themes
  • Support block based widgets
  • Support different feature image for each language

Features of the plugin WP Multilang

  • 100% free.
  • Translation at PHP.
  • Compatible with REST.
  • Support configuration for translate multidimensional arrays in options, meta fields, post content.
  • Support multisite.
  • Support WordPress in sub-folder.
  • Separate menu items, posts, terms, widgets, comments per language.
  • Many filters for dynamic applying translation settings.
  • No duplicate posts, terms, menus, widgets.
  • No sub-domain for each language version.
  • No additional tables in database.
  • Possibility set many languages with one localization. For example, for localization in the region.
  • Possibility to set custom locale for html(If installed locale is en_US, you can set locale like: en, en-UK, en-AU etc. Without installation another localization)
  • Possibility for add new languages for any user with capability manage_options.
  • Exist the role “Translator” for editing posts, terms. It can not publish or delete.
  • No limits by languages or by possibilities.

WP Multilang compatible with plugins

  • Elementor ( available in premium version ) – View Tutorial
  • ACF, ACF Pro
  • WooCommerce
  • WooCommerce Customizer
  • Gutenberg
  • Yoast Seo
  • Contact Form 7 (added mail tag [_language] for send user language in mail)
  • WPBakery Visual Composer
  • Page Builder by SiteOrigin
  • NextGEN Gallery
  • All in One SEO Pack
  • MailChimp for WordPress
  • Newsletter
  • Maps Builder
  • Max Mega Menu
  • MasterSlider
  • WP-PageNavi
  • BuddyPress
  • Meta Slider
  • TablePress
  • Download Monitor (Redefine templates for links in your theme and translate link texts)
  • Better Search
  • Rank Math SEO (thanks for @pratikmts)

Manage translation settings via json.

Add in the root of your theme or plugin file wpm-config.json.

Sample configurations can be viewed in config files in folder ‘configs’ in root the plugin.

Configuration is updated after switching theme, enable or update any plugins.

The plugin has filters for dynamic application configuration for translate.

For turn off translation, set null into the desired configuration.
For example, you must turn off translation for a post type post.
There are two ways:

  1. In json.
    Create in root of a theme or a plugin file wpm-config.json with:
    “post_types”: {
    “post”: null

  2. Through the filter.
    Add in functions.php
    add_filter( ‘wpm_post_post_config’, ‘__return_null’ );

To enable translation pass an empty array in php array() or empty object in json {}.

Supports translation multidimensional array of options, meta fields and post_content.
Supports the removal of established localizations.
Supports translation via GET parameter. Add in the GET parameter lang code desired language.
Supports clean database of translations when removing the plugin. Translations are only removed from the built-in tables.
Supports import term translations from qTranslate(by Soft79).
Supports automatically redirect to the user’s browser language, if he visits for the first time.

Ideal for developers.

For display language switcher in any place add the code to your template if ( function_exists ( 'wpm_language_switcher' ) ) wpm_language_switcher ();
Function accepts two parameters:
$type – ‘list’, ‘dropdown’, ‘select’. Default – ‘list’.
$show – ‘flag’, ‘name’, ‘both’. Default – ‘both’.

Or using the shortcode wpm_lang_switcher. It accept two not necessary parameters ‘type’ and ‘show’.

Available features for translation:
wpm_translate_url( $url, $language = ” ); – translate url
wpm_translate_string( $string, $language = ” ); – translate multilingual string
wpm_translate_value( $value, $language = ” ); – translate multidimensional array with multilingual strings

Update translation occurs at PHP. Therefore plugin has high adaptability, compatibility and easily integrates with other plugins. This is what distinguishes it among similar.

Available translation html tags by JS for strings what do not have WP filters before output.

Add your tags in config:

"admin_html_tags": {
    "admin_screen_id": {
      "attribute": [

admin_screen_id – admin screen id.
attribute – attribute what need to translate. Available ‘text’ – for translate text node, ‘value’ – for translate form values. Or other tag attribute, like ‘title’, ‘alt’.
selector – css selector for search needed tag. Each selector is a new array item.

If You need to add translation for multidimentional array for repeated elements You can use custom tag ‘wpm_each’ for set config to each element in array.
Example, add config for each item ‘title’ in custom post field array:

"post_fields": {
    "custom_field": {
      "wpm_each": {
        "title": {}

For set translation uses the syntax:
[:en]Donec vitae orci sed dolor[:de]Cras risus ipsum faucibus ut[:]

Added shortcode for translate text in any place:
[wpm_translate][:en]Donec vitae orci sed dolor[:de]Cras risus ipsum faucibus ut[:][wpm_translate]

If You translate text in established language, add lang parameter:
[wpm_translate lang=”de”][:en]Donec vitae orci sed dolor[:de]Cras risus ipsum faucibus ut[:][wpm_translate]

Support translating from syntax qTranslate, qTranslate-X, WPGlobus etc.

Compatible with REST-API.
Support transfer the required translation through option lang in the GET request to REST.
Has the ability to keep recording the target language through the transmission parameter lang in the request.

Migration from qTranslate-X

  1. Before installing/uninstalling, make database backup.
  2. Deactivate qTranslate-X.
  3. Install and activate WP Multilang.
  4. Create in root of your theme file ‘wpm-config.json’.
  5. Add all needed post types, taxonomies, options, fields to ‘wpm-config.json’. Setting from qTranslate-X not importing.
  6. Import term names from qTranslate.
  7. Check that everything is okay.
  8. If everything is okay, remove qTranslate-X. If not, make screenshots of errors, restore database from backup and add support issue with your screenshots and description of errors.


Do not support different slug for each language(Yet).

Not compatible with:
– WP Maintenance

Known issues

Function ‘get_page_by_title’ not working, because in title field are stored titles for all languages. Use function ‘wpm_get_page_by_title( $title )’ as solution.

NOTE: Because plugins have different ways of storing data, WP Multilang is not compatible with every single plugin out-of-the-box (mostly page builders). This may result in texts not being translatable or translations not being saved. Most of these issues can be resolved using the integration options (wpm-config.json or filters) of WP Multilang.

Please try WP Multilang in a test-environment before activating it on an existing production site and always make a backup before activating!

Home | Help & Tech Support | Documentation | Premium


We try our best to provide support on WordPress.org forums. However, We have a special community support where you can ask us questions and get help about your WP Multilang related questions. Delivering a good user experience means a lot to us and so we try our best to reply each and every question that gets asked.

Bug Reports

Bug reports for WP Multilang are welcomed on GitHub. Please note GitHub is not a support forum, and issues that aren’t properly qualified as bugs will be closed.


  • Settings page
  • Post list page
  • Taxonomy list page
  • Taxonomy edit page
  • Post edit page


Dizze plugin jout 1 blok.

  • Language Switcher Example block scaffolded with Create Block tool.


  1. Upload the plugin files to the /wp-content/plugins/wp-multilang directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Adjust languages on WP Multilang Settings page.


I add new translation, but it rewrite another translation on different language.

If you have opened several browser tabs for editing this post in different languages, translation will be saved for the language that you opened last.


10 july, 2024
Thank you very much to your team for timely and high-quality service and good communication. I recommend it to everyone! Thank you.
23 maaie, 2024
Pour l’instant, pour moi, cela fonctionne. Merci de votre temps pour avoir créé ce plugin !
22 maaie, 2024 1 reakce
For 3 days I have been trying to remove this plugin, which only causes annoyance and has left me countless empty pages without titles, even with the help of the support team. This is already damaging to my business as I can’t rollout according to the schedule, which means we have to bear daily costs and can’t generate any revenue. For each day the purchase price of the module should be introduced as a penalty or simply banned from Wordpress.org.
20 augustus, 2023
The plugin is not bad, perhaps the most convenient for self-translation of articles into different languages. But, I don’t understand how to remove this message that keeps popping up when editing an entry. >>>The backup of this post in your browser is different from the version below. «Restore the backup»This will replace the current editor content with the last backup version. You can use undo and redo in the editor to get the old content back or to return to the restored version.<<<
Lês alle 91 resinsjes

Meiwurkers & amp; Untwikkelders

“WP Multilang – Translation and Multilingual Plugin” is iepen boarne software. De folgjende minsken hawwe bydroegen oan dizze plugin.


“WP Multilang – Translation and Multilingual Plugin” is oerset yn 8 lokaasjes. Tank oan de oersetters foar harren bydragen.

Oersette “WP Multilang – Translation and Multilingual Plugin” yn jo taal.

Ynteressearre yn ûntwikkeling?

Blêdzje troch de koade , besjoch de SVN-repository , of abonnearje op it ûntwikkelingslogboek troch RSS .



  • feature WordPress full site editing support #46
  • fixed Conflicts with the Newsletter plugin #61
  • enhancement Changed premium tab to Premium Features in readme.txt #80
  • feature Added Language Switcher Gutenberg Block #82


  • fixed admin_html_tags leaving empty fields #41
  • feature Gutenberg view post should redirect to current language post #55
  • fixed Conflicts with the Newsletter plugin #61
  • feature Woocommerce product attributes translation issue #70
  • fixed Issue with CF7 form #73
  • fixed Language switch button interface Guternberg block button #74


  • fixed Call to undefined function #65
  • feature Admin settings page UI/UX changes #67
  • feature Added Newsletter Form #68


  • enhancement Updated website links like contact page and other info in plugin and wp.org #45
  • feature Adedd feedback popup on deactivation #54
  • feature Added compatibility with Elementor (Premium)


  • feature Different product or post images for each language #20
  • fixed Widget block translate issue #29
  • fixed Fatal Error with latest Yoast SEO plugin update #30
  • fixed Translation of special mail tags for Contact Form 7 #31
  • fixed Translation of the “title” attribute in the shortcode of Contact Form 7 #32
  • fixed wpseo_og:locale:alternate to be set properly #33
  • fixed Translate escaping text #34
  • fixed Rank Math custom fields getting duplicated on the translated posts #35
  • fixed Issue with language switcher regex for gutenberg #36


  • fixed issue with ACF PRO #12
  • fixed An error occurred when deleting a post #13
  • fixed E_ERROR in class-wpm-install.php #16
  • fixed Issue with Gutenberg reusable blocks and create pattern #17
  • fixed No translation for Title, Meta etc. if using AIOSEO plugin #18
  • fixed No Translation of URL, and social meta tags using YOAST plugin in #23
  • fixed Issue with the Rank Math Seo meta field #24


  • fixed Conflict with Yoast SEO #6
  • enhancement ( ! ) Deprecated: Hook wpseo_opengraph is deprecated since version WPSEO 14.0 with no alternative available #7
  • enhancement ( ! ) Deprecated: setcookie(): Passing null to parameter #5 ($domain) of type string is deprecated #8
  • fixed Issue with the ACF Pro plugin #10


  • fixed Compatibility with WordPress 6.4 and updated readme.txt #1
  • fixed Code Improvement #2
  • added support tab and form


  • removed support old version of ACF lower 5.0


  • added support for Rank Math SEO (thanks for @pratikmts)
  • optimized speed
  • deleted support for old translate syntax
  • other fixes and improvements


  • fixed compatibility with WordPress 5.0
  • fixed compatibility with AIOSP


  • added donate link to readme.txt
  • fix display language name
  • fix SiteOrigin Builder compatibility
  • fix fatal error when a plugin is disabled
  • fix translate REST requests in admin


  • fixed Gutenberg compatibility
  • fixed translation WC coupons

All changelog available on GitHub.