CategoriesTutorials

How to translate a WordPress theme or plugin using Loco Translate

Translating your WordPress theme or plugin into another language helps improve user experience and makes your website accessible to a wider audience. One of the easiest tools to do this is the Loco Translate plugin, which allows you to translate text directly from the WordPress dashboard without editing code files manually.

This guide will walk you through the steps to translate a theme or plugin using Loco Translate.

Step 1: Install and Activate Loco Translate

    1. Log in to your WordPress Admin Dashboard.

    2. Go to Plugins → Add New.

    3. Search for Loco Translate.

    4. Click Install Now, then Activate.

Step 2: Choose the Theme or Plugin to Translate

    1. Go to Loco Translate → Themes or Loco Translate → Plugins.

    2. Select the theme or plugin you want to translate (for example: WooCommerce or your active theme).

    3. Click on the item to open its translation page.

    Step 3: Create a New Language File

    1. Click New Language.

    2. Choose your target language (for example: French, Spanish, or Vietnamese).

    3. Select the language location:

      • Recommended: Custom location (safe from updates).

    4. Click Start Translating.

    Step 4: Translate the Strings

    1. In the translation editor, you will see a list of text strings on the left.

    2. Click on any string you want to translate.

    3. Enter the translated text in the lower text box.

    4. Click Save after translating several strings (or when finished).

    Tip: You can use the Filter/Search box to quickly find specific words such as “Add to Cart”, “Checkout”, or “Submit”.

    Step 5: Check Your Website

    1. Go to the front end of your website.

    2. Refresh the page.

    3. Make sure your WordPress site language matches the language you translated (Settings → General → Site Language).

    4. Verify that the translated text appears correctly.

    Common Tips and Best Practices

    • ✅ Always save translations in a custom folder so they are not overwritten when updating the theme or plugin.

    • ✅ Use the search feature to find strings quickly.

    • ⚠️ Some texts may come from JavaScript files; make sure “Sync” is enabled to scan all strings.

    • ⚠️ Not all plugins are fully translatable if they are poorly coded.

Troubleshooting

Problem: Translation does not appear on the site

  • Check that your site language matches the translation language.

  • Clear your cache (if using a cache plugin).

  • Make sure you translated the correct theme/plugin (parent vs child theme).

Problem: Some strings cannot be found

  • Click Sync in Loco Translate to re-scan source files.

  • Check if the text is hardcoded in PHP without translation functions.

Conclusion

Loco Translate is a powerful and user-friendly plugin that allows you to translate WordPress themes and plugins directly from the admin panel. With just a few clicks, you can localize your website and provide a better experience for users in different languages.

By following the steps above, you can easily create and manage translations without touching complex code or .po/.mo files manually.