Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Plugin how-tos · Guide

How to Translate Widgets with WPML (Step by Step)

How to Translate Widgets with WPML (Step by Step)

Short answer

Translate widget text in WPML String Translation by searching for the widget string and adding each language, or add a separate widget per language and set which language it appears on. Translate menu widgets with WPML menu sync and translate the source content for widgets that display posts or forms.

Key takeaways

  • String Translation swaps widget text without duplicating widgets.
  • One widget per language works best for block widgets and complex content.
  • Translate menus with WP Menus Sync, not the widget.
  • Load the page first so WPML registers new strings.
  • Clear page and WPML caches after adding translations.

How do you translate widgets with WPML?

You translate widgets with WPML in two ways: translate the widget text through WPML String Translation, or create a separate widget for each language and set which language it shows on.

Which method you pick depends on how different the content is between languages:

MethodBest forNeeds String Translation?
Translate widget stringsSame widget, text changes per languageYes
Separate widget per languageDifferent content or layout per languageNo
Translated menus in a menu widgetFooter and sidebar navigationNo, uses menu sync
Translate the source (post, form, block)Widgets that show other contentDepends on the source

This guide covers each method step by step. If WPML is not set up yet, start with how to use the WPML plugin in WordPress.

What do you need before translating widgets?

You need WPML installed with your languages set up, and for string-based translation you also need the WPML String Translation add-on, which comes with the higher WPML plans.

Check these first:

  • WPML core is active and your languages are added.
  • String Translation is installed if you want to translate widget text without duplicating widgets.
  • Your widgets are in place in the default language.
  • You know whether your theme uses block widgets or classic widgets.

Since WordPress 5.8, the widget screen uses blocks by default. The block-based widgets editor announcement explains the change. Some sites switch back with the Classic Widgets plugin, and WPML behaves a little differently in each.

Check WPML's site for which plans include String Translation, because plans change over time.

How do you translate widget text with String Translation?

Go to WPML > String Translation, filter by the widgets text domain or search for the widget text, add the translation for each language, and save.

This method keeps one widget and swaps its text by language. It works well for widget titles, short text and classic text widgets.

  1. Make sure the widget is saved in your default language.
  2. Go to WPML > String Translation.
  3. Use the domain filter to select the widgets domain, or search for the exact text.
  4. Click the plus icon or translation field next to the string.
  5. Enter the translation for each language.
  6. Mark it complete and save.

Then view the page in the other language and check the widget.

If you edit the original widget text later, WPML treats it as a new string. The old translation will no longer match, so you need to translate the updated text again. Keep this in mind before making small wording changes to widgets on a site with many languages.

If the string does not appear in the list, WPML may not have registered it yet. Load a page that shows the widget on the front end, then search again. For a deeper fix, see our guide on WPML String Translation not working.

How do you show a different widget for each language?

Add one widget per language to the same widget area, then use WPML's language display option on each widget so it only appears for its language.

This method is the most reliable for block widgets and for widgets with complex content. WPML has explained the approach in its post on displaying different widgets per language.

The steps:

  1. Go to Appearance > Widgets.
  2. Add the widget in your default language and save.
  3. Find WPML's language setting for that widget and choose the default language.
  4. Add a second widget with the translated content.
  5. Set its language to the second language.
  6. Repeat for each language and click Update.

In the classic widget screen, the language option appears inside each widget's form. In the block widget editor, look in the block's settings panel. If you do not see it, update WPML, since older versions had limited block widget support.

Leave the language set to all languages for widgets that should appear everywhere, such as a search box.

Name each widget clearly if your theme or a plugin lets you add a label. With three or four languages in one widget area, it is easy to lose track of which block belongs to which language.

The downside of this method is upkeep. When you change the widget in one language, you have to remember to update the others by hand, because WPML does not link them.

How do you translate navigation menus inside widgets?

Translate the menu itself with WPML's menu sync tool, and the menu widget will show the right menu for each language automatically.

Footer and sidebar menus often sit inside a Navigation Menu widget or block. You do not translate the widget, you translate the menu.

  1. Make sure your pages and posts are translated first.
  2. Go to WPML > WP Menus Sync.
  3. Click Sync to create translated menus.
  4. Review the changes and apply them.
  5. Check the menu widget in each language.

Custom links in menus may need manual translation in String Translation. Our guide on adding the WPML language switcher also covers adding a switcher as a widget.

How do you translate widgets that show other content?

Widgets that display posts, forms or reusable blocks pull their text from that content, so translate the source item and the widget usually follows.

Examples include:

  • Recent posts widgets: show translated posts once those posts exist in each language.
  • Form widgets: translate the form in your form plugin or through WPML's form integration.
  • Synced patterns or reusable blocks: translate the pattern as its own content.
  • Shortcode widgets: translate the shortcode's output where it is stored.

If a widget still shows the original language, check whether its source has a translation. A missing translation means WPML falls back to the original or shows nothing, depending on your settings.

Are widget titles and text still in the original language?

If text stays in the original language, the string may not be registered, the translation may not be marked complete, or a cache is serving the old version.

Work through these checks:

  • Load the page first. Some strings only register after they appear on the front end.
  • Check the domain. Theme or plugin widgets may use their own text domain instead of the widgets domain.
  • Mark complete. A translation saved as incomplete will not display.
  • Clear caches. Page cache and WPML's own cache can keep old text. Our guide on how to clear the WPML cache explains how.

Theme widgets sometimes have strings defined in the theme code. Those are translated under WPML > Theme and plugins localization, then in String Translation.

Does the widget disappear in one language?

A widget that vanishes in a second language usually has its language set to only the default language, or its content source has no translation.

Check the widget's language setting first. If it is set to one language, it will not show anywhere else.

Then check the content the widget relies on. A category widget shows nothing if the categories are not translated. Our guide on WPML taxonomy translation not working covers that case.

For widgets missing in every language, see the general guide on fixing widgets not showing.

Which method should you choose?

Use String Translation for short text that stays the same widget, and use one widget per language when content, links or layout differ between languages.

Some practical rules:

  • Simple title and text: String Translation is fastest and keeps one widget to maintain.
  • Block widgets with layouts: a widget per language avoids string matching problems.
  • Menus: always translate through menu sync.
  • Different offers or contact details per country: use separate widgets.

Whatever you choose, test every language in a private browser window after saving. WordPress's guide to managing widgets covers the widget screen itself.

What should you do if WPML still will not translate a widget?

Update WPML and its add-ons, check for theme compatibility issues, and contact WPML support with the widget type, the text and screenshots of String Translation.

WPML keeps a public support forum where many widget questions are already answered. Before posting, collect:

  • The WPML, String Translation and WordPress versions.
  • The theme or plugin that provides the widget.
  • Whether you use block or classic widgets.
  • A screenshot of the string in String Translation.

Theme authors register widget areas with code described in the widgets theme handbook. If a theme registers its areas in an unusual way, WPML support may need to add a compatibility fix.

Frequently asked questions

Do I need WPML String Translation to translate widgets?

Only for the string method. Without String Translation, you can still add a separate widget for each language and set which language each one shows on. Menu widgets can be handled with menu sync, which is part of WPML core.

Why can't I find my widget text in String Translation?

WPML may not have registered the string yet. Open a page that shows the widget on the front end, then search again. Also check other text domains, because theme and plugin widgets often use their own domain rather than the widgets domain.

Does WPML work with block widgets?

Yes, current WPML versions support the block widget editor. Many site owners find it simpler to create one widget per language and set the language on each block, especially for widgets with layouts, images or several paragraphs.

How do I translate a footer menu in a widget?

Translate the menu, not the widget. Translate your pages first, then use WPML's menu sync tool to create matching menus in each language. The Navigation Menu widget then shows the correct menu automatically for each language.

Sources

  1. Display different widgets per language WPML
  2. Block-based Widgets Editor in WordPress 5.8 Make WordPress Core
  3. Classic Widgets plugin WordPress.org
  4. Manage Widgets WordPress.org
  5. Widgets WordPress Developer Resources

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.