FAQ: Why don't my translations show up?
If most of your translations are showing up, but you have a problem with just a few words, see this FAQ instead.
Possible causes
To help you solve your problem, here are some possible lines of inquiry. Please don't ask us for help with specific themes or plugins. Either investigate these issues yourself or ask the bundle author how to translate their product using whatever software they recommend.
Your translation files are not being loaded
Themes and plugins have to load their own translation files and Loco Translate cannot force them to. Check that themes are calling the"load_theme_textdomain"
function, and plugins are calling"load_plugin_textdomain"
. If they're not then ask the author nicely to fix it.The files are named wrongly
It can happen that bundles declare incorrect information which causes your files to be saved with the wrong names. Check that the bundle declares the same Text Domain that it actually uses and configure Loco Translate as necessary. If you can't check this yourself, ask the bundle author to confirm what your files should be called.The strings aren't actually translatable
The bundle's template file defines the strings that are available for translation. This does not guarantee the string actually exists. Authors often ship template files that are not up to date with their source code, but Loco Translate will not argue with the author's template file.Your language isn't set correctly
You need to set your language for translations to display on your site. Although we can't provide personal help with this, see our brief guide to setting your WordPress language.Your files have been deleted
If you've saved your own custom files in the "author" or "system" locations then WordPress may have deleted or modified them during an update. See the FAQ about disappearing translation files.You can't use our custom (safe) folder
We recommended you save your own translation files in Loco Translate's "custom" folder atwp-content/languages/loco
, but this can suffer from its own problems. Themes and plugins that haven't been written properly can prevent this location from working. Please read the FAQ about custom loading problems.The translations are for JavaScript
Loco Translate supports JSON language packs for use withwp_set_script_translations
but there are other ways authors might localize JavaScript. Check with the vendor how they handle this and whether they use standard WordPress methods.
Dead end
If you've tried all the suggestions above then your best course of action is to contact the author of the theme or plugin you're translating. Don't confuse them by asking for help with Loco Translate (your choice of editor shouldn't matter). Just tell them where your MO files are saved and ask them why the translations aren't displaying.
Please don't ask us why your translations are not showing up. There is no support for this problem unless you can demonstrate the fault is with Loco Translate. We will investigate any reproducible bug, but this requires you post steps to reliably demonstrate the fault in a way that we can see it too.