Getting started
-
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…
-
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….
-
If you are not receiving WPML updates automatically, you need to update manually. As part of this manual update, you can register WPML and receive automated updates to future versions….
-
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….
-
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…
-
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…
-
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…
-
WPML offers automatic translation with the Multilingual CMS and Multilingual Agency account types. It is an optional translation method. Our automatic translations are powered by leading translation engines DeepL, Microsoft,…
Error messages
-
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…
-
You may see this message after trying to upload WPML 4.5 or later via the Plugins page in WordPress. Learn how to solve this issue.
-
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 a page…
-
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…
-
Error when registering WPML Things that you can check when getting an error message like this: Do you have a working internet connection? Can the webserver…
Compatibility
-
WPML always tests every release with the latest WordPress versions. However, because WPML is not listed in the WordPress repository, it will always show as Compatibility with WordPress: Unknown. When…
-
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…
-
The WPML support team can nearly always help you resolve issues faster when we know which theme and plugins you use. The WPML plugin can send us a report of…
-
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…
Troubleshooting
-
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…
-
There can be many reasons why translations may disappear or go missing. The simplest and most common cause is not following a consistent translation workflow. WPML offers a robust translation…
-
If you translate a string in String Translation but you don’t still see it translated in the front-end, in most cases this happens because your WP Memory Limit is set…
-
If you’re using the Classic Translation Editor, you could have trouble finishing a larger page’s translation. For example, a page that has been 100% translated and saved may appear to…
-
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…
-
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…
-
Does your site feel slow? Here are a few steps that you can take to speed it up. UpdateUpdate WordPress, the theme and all plugins PHP 7Make sure that you…
-
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…
-
If your site shows question marks for non-English characters, most chances are your database character encoding is different than UTF-8. Don’t worry, you can fix this easily. If you’re using…
-
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…
-
When using WPML’s Advanced Translation Editor, your translations may appear “stuck”. You might also see a message saying “WPML didn’t manage to translate this page” or “WPML tried to translate…
-
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…
-
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…
-
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…
-
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…
-
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…
-
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…
Getting support
-
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…
-
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…
-
Sometimes, when you report an issue, our supporters might ask you to reproduce it on a test site. They’ll also provide you with such a site. Here are some simple…
-
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…
-
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,…
How-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…
-
Sometimes, you might want to completely remove a specific translation of a page. Follow these simple steps to do this. Please note that translation memory saves your original translations. The…
-
If you create your own custom post types, custom fields, or custom taxonomies, you need to make them translatable before you can translate them. To make custom types in WordPress…
-
If you run a site such as an established blog, a content-heavy site or an e-commerce store you might have a lot of taxonomy terms to translate – far too…
-
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”…
-
If you have a page that is a translation of another page, you can link them together using the Connect with translations feature. To link pages to their translations: Open the…
-
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…
-
Even after removing a language from WPML’s options on your website, you may continue to see your theme and plugins downloading language files in that language. To fix this, 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…
-
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…
-
Sometimes, you might need or want to manually install plugins on your WordPress site. To manually install a plugin, you need to have a ZIP file containing it. Usually, you…
-
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…
-
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…
-
If you add a sidebar language switcher to a site using the Twenty Seventeen theme, there is a slight visual issue in its appearance. Front-end glitch…
-
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…
-
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…
Misc
-
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…
-
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…
-
This is currently not possible with WPML. Once you have set any page as your Front or Post page on the Settings → Reading page, WPML will immediately assign their…
-
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. Where To Find Your…
-
In WordPress, the text domain is a unique identifier that allows WordPress to distinguish between all loaded translations. It also makes it easier for WordPress to know which strings belong…
-
HTML tags are letters or keywords enclosed in <> brackets that define how a browser will format and display content. For example, let’s say you have some words in a…