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

Troubleshooting

WPML Media Translation Not Working: Causes and How to Fix It

WPML Media Translation Not Working: Causes and How to Fix It

Short answer

WPML media translation usually breaks because the Media Translation add-on is inactive, older images were never set up for translation, or translated posts were not updated after an image swap. Page builder data, custom fields and caching can also keep showing the original image.

Key takeaways

  • Media translation needs the separate WPML Media Translation add-on.
  • Run the media setup options in WPML settings for images uploaded before WPML.
  • Update translated posts after uploading a language-specific image.
  • Set ACF image fields to Copy or Translate in WPML's field settings.
  • Purge every cache layer before testing again.

Why is WPML media translation not working?

WPML media translation usually fails because the add-on is inactive, older media was never set up, translations were not updated after an image swap, or a builder, field or cache serves the original.

The good news is that the fixes are mostly settings, not code. Most sites need two or three changes, followed by updating the affected translations.

It helps to know what WPML does with media. Each image in your library can have a version per language, and translated posts point to the translated version.

When that link breaks anywhere along the chain, visitors see the original image, or the same alt text, in every language. WPML's media translation guide explains the full system.

Is the WPML Media Translation add-on active?

Check Plugins > Installed Plugins for WPML Media Translation; if it is missing or inactive, the Media Translation screen and image swapping per language won't exist.

Media translation is an add-on, not part of the core WPML plugin. It ships with the higher WPML plans, so check which plan your account includes.

Steps:

  1. Go to Plugins > Installed Plugins and look for WPML Media Translation.
  2. If it is missing, install it from Plugins > Add New Plugin > Commercial tab, which WPML adds once your site is registered.
  3. Activate it.
  4. Confirm that WPML > Media Translation now appears in the menu.

Keep the add-on on the same release line as the core plugin. A version gap between WPML parts is a common cause of odd behavior.

If WPML itself is new to you, our guide on how to use the WPML plugin covers the basic setup.

Has existing media been set up for translation?

Media uploaded before you installed the add-on may have no language information; run the media setup options in WPML's settings so older images can be translated.

Go to WPML > Settings and find the media translation section. The options there include:

  • Set language information for existing media. Assigns a language to images uploaded before WPML.
  • Duplicate existing media for translated content. Creates per-language copies of older images.
  • Duplicate featured images. Copies featured images to translated posts.
  • Make new uploads available in all languages. Applies to images you add from now on.
  • Translate media library texts with posts. Sends alt text, captions and titles along with the post translation.

Run the process, wait for it to finish, and do not close the tab while it works. On large libraries it can take a while.

Exact labels can change between WPML versions. If you cannot find an option, search the settings page for media.

Did you update the translated posts after changing an image?

Translated posts do not pick up a new image on their own; after you upload a replacement in Media Translation, update each affected translation so it points to the new file.

This is the most common reason people think media translation is broken. You swap the Spanish image, but the Spanish page still shows the English one.

Steps:

  1. Go to WPML > Media Translation.
  2. Find the image and upload the replacement for the target language.
  3. Open WPML > Translation Management or the post's language box.
  4. Look for translations marked as needing an update.
  5. Update and complete those translations.

Once the translation is saved again, it uses the language-specific image. Clear your cache after this step.

If text translations are also stuck, our guide to WPML translation not working covers the translation editor side.

Are alt text and captions not translating?

Turn on the option to translate media library texts with posts, then send or update the post's translation so the alt text and caption appear in the translation editor.

Alt text matters for accessibility and for image search. The MDN guide to the img element explains why every image needs a useful alt attribute.

If alt text still shows in the original language:

  • Check the setting. The texts option must be on before you send the translation.
  • Re-send the post. Older translations were made without the media fields.
  • Check where the alt text lives. Alt text typed in a page builder widget is part of the page content, not the media library.

Images placed with Elementor or another builder often store their own alt text inside the layout. Translate those in the page translation, not in Media Translation.

Is a page builder or custom field showing the original image?

Builders and custom fields store image IDs or URLs in their own data, so WPML needs the right integration or field setting to swap them per language.

Page builders. WPML supports major builders through built-in integrations. Update WPML and the builder, then update the translation. Our guide on using WPML with Elementor covers that pairing.

If Elementor pages still show wrong content after updating, see WPML and Elementor not working.

Custom fields. Image fields from ACF or similar plugins need a translation preference. In WPML's custom field settings, choose Translate if each language needs a different image, or Copy if the image is the same everywhere.

Hard-coded URLs. Images inserted as plain URLs in HTML or theme files bypass WPML entirely. Replace them with proper media library images.

Where the image livesHow WPML handles itFix
Featured imageDuplicated or translated by media settingsTurn on featured image duplication
Block editor image blockSwapped when the translation is updatedUpdate the translation
Page builder widgetHandled by WPML's builder integrationUpdate both plugins, then the translation
ACF image fieldFollows the field's translation preferenceSet Copy or Translate
Theme file or raw HTMLNot handledUse a media library image

Is caching hiding the translated images?

Page caches, CDNs and image optimization plugins can keep serving the old image after you fix WPML, so purge every cache layer before you test again.

Clear caches in this order:

  1. Your cache plugin.
  2. Your host's server cache.
  3. Your CDN.
  4. Your browser, or test in a private window.

WPML also keeps its own cached data. Our guide on clearing the WPML cache shows where the button lives under WPML's troubleshooting screen.

Image optimization plugins that rewrite image URLs, for example to serve WebP files, can point every language at the same file. Exclude those pages briefly to test whether that is the cause.

For background on how browsers store files, see MDN's HTTP caching guide.

Could a plugin conflict be breaking media translation?

Yes; media library plugins, folder managers and offload plugins can change how attachments are stored, so test with them disabled on a staging copy.

Plugins that often interact with media:

  • Media folder or library organizer plugins.
  • Offload plugins that move files to cloud storage.
  • Image optimization and WebP plugins.
  • Lazy loading scripts that rewrite image tags.

Make a staging copy, switch to a default theme, and turn off non-WPML plugins. If translation works, turn plugins back on one by one.

Our guide on setting up a staging site shows how to test safely.

What should you do if nothing works?

Collect your WPML debug information, check the PHP error log, and open a ticket with WPML support with the steps that reproduce the problem.

Before contacting support:

  • Update everything. WPML core, all add-ons, WordPress and your builder.
  • Turn on logging. Our guide to enabling debug mode explains how, and the WordPress debugging handbook lists every debug constant.
  • Copy the debug info. WPML has a debug information page under its support menu.
  • Note one example. Give the page URL, the language and the image that is wrong.

WordPress explains media basics on its Media Library screen documentation, which helps when checking whether an image is really a library attachment.

The WPML getting started guide is also worth re-reading if settings were changed by someone else.

Frequently asked questions

Why does my translated page still show the original image?

The translation was probably not updated after you added the new image in Media Translation. Open the translation, update it so it picks up the language-specific image, then clear your cache and check the page again.

Is WPML Media Translation included in every plan?

No. It is an add-on that comes with the higher WPML plans. Check your account to see which add-ons your plan includes, and upgrade if Media Translation is not listed.

Do I need to translate images that have no text in them?

Usually not. Images without text can be shared across languages. You still want translated alt text, though, so enable the option to translate media texts with posts.

Why are image alt texts missing from the translation editor?

The setting to translate media library texts with posts was probably off when the job was sent. Turn it on, then resend or update the translation so the alt text and caption appear.

Can caching cause WPML image problems?

Yes. Page caches and CDNs can keep serving an old version of a page with the original image. Purge the cache plugin, server cache, CDN and browser before deciding the fix did not work.

Sources

  1. Media translation WPML
  2. Getting started guide WPML
  3. Media Library screen WordPress.org
  4. The Image Embed element MDN Web Docs
  5. HTTP caching MDN Web Docs

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.