Skip to content
qTranslate-XT (eXTended) - reviving qTranslate-X. Will become a new community-driven plugin soon. Modules for WooCommerce, ACF, All in one SEO, Events Made Easy, Gravity Forms. GUTENBERG now available for dev/beta preview!
PHP JavaScript CSS
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin Check DOING_AJAX with wp_doing_ajax (#747) Oct 20, 2019
dev Check WP_ADMIN with is_admin (#747) Oct 20, 2019
flags Fixed wrong burmese flag Jun 20, 2016
i18n-config cleanup: reformat json files Mar 31, 2019
img images moved to a subfolder Apr 25, 2016
inc Reformat PHP code with 4 spaces (#737) Oct 20, 2019
lang Fix new Wiki hyperlinks with anchors Jun 25, 2019
modules Check DOING_AJAX with wp_doing_ajax (#747) Oct 20, 2019
.gitattributes Force LF on sources checkout Oct 19, 2019 Release 3.7.1 Oct 20, 2019 Increase required WP version to 4.8 (#747) Oct 20, 2019 Archive qtranslate-X changelog separately Oct 11, 2019
composer.json Update license, authors and links for Composer Oct 16, 2019
i18n-config.json Update vendor info in i18n-config.json (#702) Jun 25, 2019
license.txt Update licence to GPLv2 or later Oct 13, 2019
qtranslate.php Release 3.7.1 Oct 20, 2019
qtranslate_compatibility.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
qtranslate_core.php No front-detect redirect on neutral path (#749) Nov 3, 2019
qtranslate_date_time.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
qtranslate_frontend.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
qtranslate_hooks.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
qtranslate_options.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
qtranslate_utils.php Check properly WP_CLI (#747) Oct 20, 2019
qtranslate_widget.php Reformat PHP code with 4 spaces (#737) Oct 20, 2019
readme.txt Increase required WP version to 4.8 (#747) Oct 20, 2019

qTranslate-XT (eXTended)

Developed by: new qTranslate community, from qTranslate-X by John Clause and qTranslate by Qian Qin
Contributors: herrvigg, johnclause, chineseleper, Vavooon, grafcom
Tags: multilingual, language, admin, tinymce, bilingual, widget, switcher, i18n, l10n, multilanguage, translation
Requires: 4.8
Tested up to: 5.2.4
Stable tag: N/A
License: GPLv2 or later
License URI:

Adds user-friendly multilingual content support, stored in single post.


The qTranslate-XT plugin is an eXTended version of qTranslate-X that we are reviving with a new community, since the original plugin is abandoned by its author. Our first goal is to maintain the essential features of this plugin with the last Wordpress and PHP updates. The migration to Gutenberg will be a critical milestone for the survival of this plugin. We are currently building a new organization to give qTranslate a new life. Let's try together, anyone is welcome to participate!

GitHub repository of the new repo:


Since the -XT version is not officially available at the initial installation must be done manually. You require the permissions to access the plugins folder of your Wordpress installation. Contact your system administrator if needed.

  1. Download the last release from GitHub in zip or tar.gz format (usually zip for Windows users). Alternatively, for developers and those familiar with git, you can git clone the new repo and work on the current branch.
  2. Uncompress the archive in your plugins folder and rename it to qtranslate-xt.
  3. Deactivate plugin qTranslate-X, qTranslate, mqTranslate, qTranslate Plus, zTranslate or any other multilingual plugin, if you are running any.
  4. Activate qTranslate-XT through the 'Plugins' admin page in WordPress (/wp-admin/plugins.php).

If you didn't already have qTranslate-X, proceed with the initial setup of qTranslate-XT:

  1. Open Settings > Languages configuration page and add/delete/disable any languages you need.
  2. Add the "qTranslate Language Chooser" widget or "Language Switcher" menu item to let your visitors switch the language.

Check the FAQ for further instructions.

Frequently Asked Questions

Why is qTranslate-X not maintained anymore?

The previous qTranslate-Team was only one person. We tried to contact the author many times but we got no answer since 2016. Our goal is to build up a real team and make this plugin available again for the whole community. We can't update the official plugin yet. It is still not clear either if we should go on with the qTranslate name, but for now we should focus on new releases. The -XT version can be seen for the least as a "bridge" project.

I'm still using qTranslate-X, can I test qTranslate-XT?

Yes and it's very easy! Currently you can have both qTranslate-X and qTranslate-XT installed in the plugins folder for experimentations, but you should have at most one active at any time: BOTH -X AND -XT SHARE THE SAME OPTIONS! So if you change some options and switch between the plugins, the last changes will remain for the other. The plugin can actually re-adapt its configuration after a switch, in the general case you have nothing to do. If you have some incompatible options you should see some warnings. Note that even if you uninstall either -X or -XT, the options are not erased!

Disclaimer: we cannot guarantee that all the functionalites are preserved and the installation is at your own responsibility. Be sure to backup your database regularly.

Is the block editor (Gutenberg) supported?

Not yet. Some work is in progress but don't expect this soon.

Is WooCommerce, ACF, ... supported?

WooCommerce, ACF and other plugins are now supported as built-in modules. Developers able to test properly are much welcome! Please send PR for bug fixes. See the complete list of available modules in our repo.

Is any plugin/themes supported?

Some major plugins are now supported with the built-in modules. Some plugins are also supported with built-in i18n configurations. For other plugins you need to provide custom integration through i18n configuration (json) and/or code (PHP/JS). A major refactoring is needed to make this easier.

I'm new to qTranslate, where can I find detailed instructions for startup?

Check our Wiki pages:

How to update qTranslate-XT with the last release?

Since the -XT version is not available at, we recommend you to install GitHub Updater. This is is an awesome tool to update plugins from a git repo (with many other features). It checks regularly the last release available in github (from the git tags) and compares it to your current version (defined in the header of qtranslate.php). If a new release is available an update link will appear as for a regular plugin from Wordpress. The check is performed even if the plugin is deactivated.

Alternatively you can delete the current folder and repeat the installation from the last archive. Make sure to deactivate the previous version and then activate the new one, otherwise you will miss the execution of activation hooks and some options may become misconfigured.

Note for developers:

  • since GitHub Updater deploys the archive (tarball) your local git project will be removed if you installed it through git clone. If you want to use a cloned version in production you should not update through GHU, use git pull instead.
  • old releases may contain legacy headers that can become problematic. Be very cautious if you customize the updates for given branches!

Upgrade Notice


New feature! The built-in modules replace the legacy plugins for integration. You have to deactivate/reactivate qTranslate-XT to detect the active modules. See in modules for more info.


Fix REST API: no redirect allowed. Your rewrite rules should be updated by saving the permalink structures from the admin page.


This is the first official release of qTranslate-XT! Please check the CHANGELOG and FAQ.


See original plugin.


Check the for the full history.

Known Issues

The previous issues have been duplicated to our new git repository. Please check the git issues before creating new ones.

The legacy issues should also be reviewed before starting using the plugin.


  • Thank you to all people motivated to make this plugin live again!
  • Thank you to the authors of the legacy versions, first of all qTranslate-X by John Clause, qTranslate by Qian Qin and all the previous contributors.

Desirable Unimplemented Features

  • refactor integration API, possibly without json files (i18n-config.json)
  • support for Gutenberg
  • support for translatable slugs
  • support for localized hreflang with country/region codes (ISO 3166-1 alpha-2)
  • unit/integration tests, automated CI tests
  • utilities for DB maintenance (audit, cleanup)
  • legacy of desirable features.
You can’t perform that action at this time.