FAQ

After purchasing a WPML account, you should receive an email with your account information. Sometimes, you might not be able to find it in your main inbox. This page offers some suggestions on finding this email. If you are having difficulties finding the email with your account information, make sure the email address you are […]

WPML includes its own automatic update and install process. After you install the base WPML plugin once, you can auto-install its components and receive upgrades directly to the WordPress admin. In this article First time WPML installation Registering WPML to receive automatic updates Unregistering WPML Updating WPML Checking for updates Updating sites that use WooCommerce […]

Having trouble registering WPML on your site? Here are some common troubleshooting tips to help you. I don’t see the registration link for WPML in my site’s admin. This means that you are using an older version that didn’t have it yet. No worries, download and install WPML manually from your wpml.org account. Updates will […]

If you are not receiving WPML updates automatically, you need to update manually. After this manual update, you can register WPML and receive automated updates to future versions. For manual updates, follow these steps: Ensure that you have a database backup for the site. You can back-up your database using plugins like Duplicator, BackupBuddy or […]

We offer you a complimentary download of Toolset Types right from your account’s download page. You can use this plugin on sites with or without WPML. If you have WPML installed and registered on your site, Toolset Types is automatically registered as well. If WPML is not installed on your site, you need to register […]

By default, you should use the stable and fully tested versions of WPML. However, in some cases, you may want to test versions that have not yet been officially released. There are three types of releases, also called “channels”: Production – this is the default channel and includes only the official, stable releases. It is […]

Your registration site key is unique to the site’s domain. If you are frequently moving the database between production, development, and staging, you can avoid re-entering the site key by setting the site key in the wp-config.php file. To set a different site key per environment: Generate a different site key for each of the […]

You can use WPML for whatever use and even modify the code. The number of sites you can register WPML on depends on your account type: Multilingual Blog – 1 site Multilingual CMS – 3 sites Multilingual Agency – unlimited sites WPML is licensed under GPL. This means that you are free to do whatever you […]

Selecting a good hosting solution for your site is very important. Good hosting should be fast, run on new versions of server software and be WordPress and WPML-ready. There are hundreds of hosting companies to choose from, so selecting one is not always easy. This is why we partnered with some of the biggest and […]

Lucky for us, WordPress has anticipated situations where things don’t quite go as planned and included debug facilities which will show you what the problem is. Have a look at the debugging WPML page to see how to activate the different debug resources and where to report problems.

A 500 error means that there is an error in the PHP code that your site runs. When errors are not caught, the server stops everything and returns page that says “500 error”. Different servers are configured to display these 500 errors slightly differently, but they all mean the same – there is an unhanded […]

There are two error messages you might see if WPML has a broken table that needs to be fixed in the database: “There is a problem with the String Translation table in your site.” “We have detected a problem with some tables in the database.” “There is a problem with the String Translation table in […]

Things that you can check when getting an error message like this: Do you have a working internet connection? Can the webserver access that host specified in the error message (api.wpml.org) via http (you may want to check this with your web server administrator or host provider).

WPML provides the Advanced Translation Editor, which comes with a built-in automatic translation feature. Advanced Translation Editor allows you to automatically translate a page at once or field-by-field.

WPML offers automatic translation as one of the many features within the Advanced Translation Editor. This integration includes a number of benefits, however, it also means it is not possible to use your own API key. The Advanced Translation Editor includes additional features that save you money We know it can be frustrating to have […]

Some plugins use a special configuration file in order to be fully compatible with WPML. For many plugins, this configuration is stored on a WPML repository and the file is retrieved when the new plugin is activated. In case caching issues prevent this from happening you can run this manually. Go to Dashboard -> Updates. Scroll […]

The WPML support team can nearly always help you resolve issues faster when we know the theme and plugins that you use. The WPML plugin can send us a report of the plugins and theme that you are using. When this option is selected, we will include your currently active theme and plugins on your […]

Untranslated post object and page link fields do not show on the back-end of the duplicated post despite the fact that the post is associated with the correct value for the post object and page link custom fields in the database. Please note that this is not a bug and it does not affect the functionality. All the textual elements will be presented […]

When you activate WPML, it adds language attributes to all existing content. If the activation process is interrupted, some content may be missing because it has no language. Read this FAQ for instructions on how to repeat the initialization process and get all your content to show again.

If you can’t get past the language configuration wizard, there’s probably something wrong between WPML, your theme and other plugins. This FAQ will help you identify these problems, so that we can find a solution and get you going. 1. Enable a PHP debug file When you activate WPML, it creates language tables in your […]

Does your site feel slow? Here are a few steps that you can take to speed it up. Update Update WordPress, the theme and all plugins PHP 7 Make sure that you are running PHP 7 and above Cache Use a caching plugin Host Use a fast host Fast website Updating WordPress and all plugins […]

Every plugin that you add to your WordPress site will add execution time and database queries. In this tutorial, we explain how to check where execution time comes from. With this information, you and WPML support team can find bottlenecks and improve your site’s performance. This tutorial is intended for developers. If you are looking […]

If your site shows question marks for non-English characters, most chances are your database character encoding is different than UTF-8. If you’re using PHPMyAdmin, the structure of your wp_posts table should look like this: If you see a different value for the collation, it means that the character encoding is wrong. This will cause text […]

As of WPML 4.3, WPML uses MO files to deliver String Translation without loading the database. For this to work, WPML needs to be able to write to the languages folder whenever you translate strings. If you are seeing a message that tells you that WPML cannot write MO files, 99% of the time it’s […]

For translations to appear on the String Translations page, the following conditions have to be met: The text must be wrapped in gettext calls There must be a textdomain argument For more information on each of these conditions, please see our article on enabling text translation for themes not compatible with WPML. Synchronizing translation files […]

By default, WPML does not load every single string onto the String Translation page. In order to add strings to that page, you may need to scan your theme or plugin for strings, or you need to register strings as translatable. For more information on how to add these strings to the String Translation page, […]

The language controls on the WooCommerce Products page are hidden by default. When enabled, they can increase the loading time of the page. The recommended place for translating products is from the WooCommerce Multilingual products dashboard. The dashboard and the Products tab can be reached in the WordPress administration area, by going to the WPML->WooCommerce Multilingual page. You can […]

Sometimes, you will want to show translated breadcrumbs on your Product pages and have them include the Shop link. Because of how WooCommerce works, this functionality requires two things to be set-up: You need to set your permalink product base to your shop slug. You need to set the product base, configured on the Settings->Permalinks page, to […]

WPML allows you to add and customize language switchers to your site menus, widget areas, and footers. You can do this from the WPML → Languages page. If you enable flags in the language switcher, you can also define their size. In some cases, the size of the flags on the front-end might be different from […]

The WooCommerce Stripe Payment Gateway extension features a Test mode for testing the payment system before activating it on a live production site. When the Test mode is enabled, the extension adds a test message to the front-end output. This message can be translated using WPML’s String Translation, but the issue is that these translations are not displayed on the […]

WPML does not display translations of admin strings in your site’s backend. This means you will always see these strings in the default language, even if you have translated them and changed your user language. The translations will display on your site’s front-end or in AJAX requests. Let’s say we want to translate our site’s […]

Save time in the support queue by checking these four easy fixes before you open a ticket. Even if they don’t immediately solve your problem, completing this checklist will give our support team a head start on providing a solution. Are your WordPress version, theme, and plugins all up to date? One of the advantages […]

If after following all the instructions from our checklist before opening a ticket in WPML support, you are still having issues or struggling to translate your site, it may be time to come to our support forum. The first thing you will notice is that our system will ask you to describe what are you […]

Sometimes, our supporters may ask you to provide them with a copy of your site. They will do this when issues you are reporting need to be investigated in greater detail. Using a copy of your site is the safest and most convenient way to debug problems. There are multiple WordPress plugins that allow you […]

In order to expedite handling your support requests, you can give to the WPML support team debug information from your site. This information includes general info about the server configuration, installed versions of WordPress, plugins and the theme. None of this information is private and does not include any data that may be used to […]

By default, the Advanced Translation Editor hides URLs from translated material. To translate URLs, you first need to find them using the search. This same method applies to other hidden elements such as shortcodes and custom HTML attributes

To make custom types in WordPress multilingual, your custom types need to be declared according to the recommended WordPress procedure: Make sure they’re registered on the init hook Never use a GetText call for the custom post type Always use the constants TRUE and FALSE. 0 and 1 may not work. Check the WordPress Codex for […]

Sometimes, you might have a lot of taxonomy terms to translate. For example, you might be running an established blog, a content-heavy site or an e-commerce store. In this case, you could find yourself with far too many taxonomies to translate one by one. Luckily, there’s a simple way to translate all taxonomy terms at […]

WPML 4.0 version introduced the possibility to translate custom taxonomy base slugs. For example, let’s say you have a custom taxonomy called “Book Genres”, with some terms like “Science Fiction” and “Biographical”. WPML allows you to translate all of them, including the base slug (“book-genres”) of the “Book Genres” taxonomy itself. To enable this, go […]

If you have a page that is a translation of another page you can link them. To link page to their translation use the Connect with translations feature. Use the following steps to link already translated pages: Open the translated version of a page for editing Set the language of the page in the Language box . Click […]

WPML allows you to easily create a PO file for any plugin or theme on your site. PO file contains a list of all texts in a plugin or a theme. Translators then use CAT (Computer-assisted Translation) software or an online service to translate the texts in PO files. Before you start, make sure you […]

WPML provides a reset feature that deletes WPML tables from the site’s database and deactivates the plugin. WPML reset cannot be undone. We recommend that you create a backup of your site before resetting WPML. The reset action does not delete translated images, translated posts, and translated taxonomies. It only affects translation and language information […]

Once you save the options for your site’s default language or a custom language, it is not possible to change their language code. If you want to use a different code for a specific language, for example, jp instead of ja for Japanese, or if you want to change the language code for a specific […]

Many themes are already multilingual-ready. Read this FAQ for common pitfalls and how you can avoid them when creating new WordPress themes.

If your translated pages appear slower than the original pages, there are a few things you can do. First, be sure to check where problems are coming from. You can learn how to use Debug Objects plugin and identify performance issues in our FAQ on debugging performance problems. When you see an unexpectedly large number […]

Many themes, plugins, and even WordPress Core use English as a default language. Because of this, if you use a different default language for your site, you will have strings belonging to different default languages. These strings may get categorized in the wrong language. In order to translate them successfully, you may need to correct […]

If you add a sidebar language switcher to a site using the Twenty Seventeen theme, there is a slight visual issue in its appearance. This happens due to some styling conflicts and can be easily fixed using the following solution. Go to the WPML -> Languages page and add the following CSS rules to the Additional CSS section of the Language switcher […]

If you add a footer language switcher to a site using the Twenty Seventeen theme, it is not visible on the front-end. It is actually rendered, however, the default styling settings make it not visible. Let’s take a look at two simple solutions to make the footer language visible in the Twenty Seventeen theme. Feel […]

Disconnecting a translation can be useful if you would like to turn the translation into an independent post, or if you would like to make it a translation of a different post. To disconnect a translation from a default language post or page: Go to the post or page in the default language. In the […]

You should not bundle WPML with any theme, free or commercial. WPML comes with GPL license, but is also trademarked. In practice, removing all the trademarked material from WPML would be a huge project and is really not recommended. We understand that theme authors want to provide a complete package for multilingual sites for their […]

This is not possible at this moment with WPML. Once you have set any page as your Front or Post page on the Settings -> Reading page, WPML will immediately assign their translations to secondary languages. You can even notice that if you delete and remove from the trash a page that was selected as […]

First, thank you again for buying WPML from us. We’ve made it easy for you to get a tax receipt, with everything needed for your accounting. Log in to your WPML account and click on the Personal details and password link. Make sure that the Company text field is filled. This information will show in your […]