
Loco Translate enables in-browser editing of WordPress translation files and integrates with automated translation services.
It also provides developers with Gettext/localization tools, such as string extraction and template generation.
Features include:
- A built-in translation editor within the WordPress admin dashboard.
- Integrates with translation APIs, including DeepL, Google, Lecto, Microsoft, and OpenAI.
- Create and update language files directly within themes or plugins
- Extract translatable strings from source code.
- Native MO file compilation—no Gettext required on your system
- Compiling JSON (Jed) files for compatibility with WordPress script localization
- Supports standard PO features, including comments, references, and plural forms
- PO source view with clickable source code references
- A protected language directory for storing custom translations.
- Configurable PO file backups with diff and restore capabilities
- Built-in WordPress locale codes
Official [service] by Tim Whitlock Loco WordPress plugin.
For more information, please visit ourPlugin page。

How to use Loco Translate
The help pages in this section explain various aspects of the Loco Translate WordPress plugin.
- New users should start by readingWhat it does;
- Beginner's guideProvides an example workflow;
- Experienced translators may want to read theTechnical Overview。
Using Loco Translate typically involves one or more of the following steps:Configuring bundles...
Configuring bundles...
Not every theme or plugin is translation-ready. If you’re lucky and your bundle contains everything Loco needs, you won’t have to worry about this. However, experience has shown us that in many cases, Loco Translate requires a bit of guidance.
Create a template
If you are developing your own theme or plugin, you will need to create a translation template. If you are translating someone else's work, hopefully, they have provided a template for you. In either case, it is helpful to understand how templates work and why they exist.
Translate phrases
This is the primary starting point if you simply want to add custom translations to a theme or plugin.
Configuring third-party translation providers (key)...
Automatic translation service integration forTranslation file editorThis is accessed via two functions, both of which prompt you to:Robot icon
-
The "Auto" button on the main toolbar enables automatic translation of the entire file. You will see a calculation of the number of characters to be sent to the service provider; this may affect the costs charged by the provider or the consumption of your free quota.
-
The "Suggest" feature is available within each individual translation window. (Shortcut: ). This feature...ImmediatelyConnect to any translation services you have configured and use them for translations. Seeeditor documentation。Ctrl J
Supported services/APIs
The following machine translation services are supported by Loco Translate via their respective APIs. You must register for each service you intend to use and generate an API key.
Please click the official links below for the latest information on using each service. Please note that the provider you choose...You may be charged... We...Alphabetical orderA list of providers. We do not endorse or promote any specific one.
- Jump to DeepL Translator
- Jump toGoogle Translate
- Jump to Lecto AI
- Jump to Microsoft Translator
- Jump to OpenAI / ChatGPT
- See alsoOther providers,What is free?
DeepL Translator
You need DeepL API Free or DeepL API Pro plan that grants access to their API. Make sure to purchase the correct one.
v2
Follow these steps to generate an API key:
- Get a DeepL account and subscribe to a API Plan。
- Go to your... DeepL Account Settingsand copy the authentication key to your clipboard.
- Paste your key into Loco Translate Plugin settings...
The correct endpoint is detected based on your API key. Keys that include specific suffixes are handled automatically.":fx"api-free.deepl.com
If you have any questions regarding DeepL plans or API access, please consultTheir supportPersonnel.
Google Translate
Google Translate is part of Google Cloud. You will need a simple API key to use it with Loco Translate.
Follow these steps to generate an API key:
- Sign up Google Cloud。
- Go to the Cloud Console and...Create a new project。
- Navigate to "APIs & Services," click "Enable APIs and Services," search for "Cloud Translation API," and click "Enable."
- At this point, you may need to enable billing. Using Google's API is not free, butWe do not charge you。
- From APIs & Services > CredentialsGenerate a key. Click "Create credentials" and select "API key."
- We recommend clicking "Restrict Key" and limiting it—at the very least—to the Translation API.
- In Loco Translate Plugin settingsEnter your API key.
If you run into trouble, read more here about Google Cloud API KeyFor more information about... Ignore any references to service accounts; Loco Translate does not support them.
For added security, you can restrict the API key to your IP address; however, please note that thisYour IP address (not the server's IP address). Requests to the API are…Works directly from your browser's.
Lecto AI
Lecto AI offers a free trial of its translation API, along with a range of solutions for handling large volumes of text.Paid plans... You will need a simple API key.
Follow these steps to generate a Lecto API key:
- Sign up Lecto AI。
- Continue with the free plan, or choose aSubscription plan。
- From Lecto DashboardCopy the pre-generated API key.
- In Loco Translate Plugin settingsEnter your API key.
Loco is... Lecto AI 's recommended partners. However, we do not promote their products over any others listed here.
Please note that as of Loco Translate 2.5.6, a maximum of 1,000 characters is sent per request to the DeepL API. Although higher-tier plans support larger request bodies and parallel requests, the plugin does not support these features.
Microsoft Online Translation
The Microsoft Translator Text API (its full name) is part of Azure Cognitive Services. It requires an Azure account and a subscription API key.https://aka.ms/MicrosoftTranslator
Follow these steps to generate a Microsoft API key:
- Sign up Microsoft Azure
- In...in the portal...Click "Create resource," search for "Translate text," and then click "Create."
- Complete your subscription by selecting a pricing tier and region (or choose "global").
- Select "API keys" under the "API keys" section of your subscription and make a note of the key.
- In Loco Translate Plugin settingsEnter your API key.and region。
Please note that if you create a subscription in a different region, you will need to enter the corresponding short code in Loco Translate. For example, "Western Europe" is actually [code]. Specifying the wrong region will result in an authentication error.globalwesteurope
Depending on your Azure customer status, you may be eligible for a free trial before setting up billing. Contact Microsoft to find out.Pricing... We do not charge you, nor can we provide advice regarding pricing.
If you encounter issues during these steps, try searching on StackExchange microsoft-translator Tags.
OpenAI (ChatGPT)
This implementation uses OpenAI'sChat Completion API to perform bulk translation of source strings. You will need an OpenAI account and an API key. Please note that this API is significantly slower than other providers listed here.
Follow these steps to generate an OpenAI API key:
- Register for an OpenAI account。
- Go to the dashboard... API Key...section.
- InBilling sectionCheck whether you have sufficient credit to meet your needs.
- In Loco Translate Plugin settingsEnter your API key and add a custom prompt if desired.
We advise restricting the scope of your API key as much as possible; please note, however, that it requiresWrite permissionsaccess to use the Chat Completions API.
Other providers
In addition to these built-in providers, Loco Translate offers a hook-based architecture that allows you to add your own external services. The following plugins can be installed manually via Git:
- Mock translation API :
A sample translation provider that generates well-formatted nonsense—useful for debugging without incurring significant costs.
Free vs. Paid
Some of the providers listed above may offer free trials or a certain amount of free quota, so please check the information on their respective websites. However, if you are a heavy user, all the machine translation services we have reviewed will eventually charge a fee.
If you plan on light usage, we recommend using a service that offersUsage-based...operates on a pay-per-use basis rather than a monthly subscription. Pricing is typically based on the number of characters (per million). To put this in perspective: Loco Translate itself contains approximately 13,000 characters of translatable text. The WordPress core contains about 300,000 characters in total—though you may find that it has already...Translate into your own language... We are able to translate dozens of plugins using the free quotas provided by some of these services.
Be wary of third-party add-ons that offer free, unlimited translations—especially those that don't require an API key—purportedly provided by major tech companies. They may engage in practices that violate the service's terms and conditions—for example, making it appear as though you are using their web interface. Such products may stop working once the provider closes these loopholes.
The collapsible box above contains the detailed official instructions; if that seems too complicated, here is a simpler method:
A simple way to use the Loco Translate plugin
Install via your WordPress search... Loco Translate Plugin.
In the Loco Translate plugin settings, you can add a translation API—Google Translate is recommended. (Setup is straightforward: simply configure the Google API service—it’s free. For details, see the tutorial in the collapsible box above or visit the official documentation page.)Automatic Translation – Loco)
Go to Loco Translate > Themesand select your theme.
Click "Add."New language。
Then click "Edit" and select "Auto" to perform the translation.
This primarily involves configuring a third-party translation service.
If you are unable to get it working, paid assistance is available; all high-quality international themes featured on this site can be translated into Chinese—or any other language—using this method.