Docs

TranslatePress

3 min readUpdated November 9, 2026

This page explains how WP Media Cloud works with TranslatePress. Translated pages get CDN URLs with no setup. The one thing to check is images you translated by hand before you set up WP Media Cloud.

What the integration does#

TranslatePress card on the Integrations tab

WP Media Cloud has no TranslatePress hooks. The TranslatePress class only detects TranslatePress and shows its status on the Integrations page. Compatibility comes from the order in which the two plugins work:

  1. WordPress renders the page. WP Media Cloud rewrites media URLs to the CDN during rendering, through its attachment URL filters and the_content.
  2. TranslatePress captures the finished HTML in an output buffer and swaps in the translated strings.
  3. Because TranslatePress works on HTML that is already rewritten, it sees CDN URLs.

TranslatePress does not create a separate attachment for each language. Every language uses the same Media Library item, so there is nothing extra to offload and no duplicate records.

Srcset. When TranslatePress swaps a translated image and the tag has a srcset, it rebuilds the srcset with WordPress functions. WP Media Cloud filters those at priority 99, so the rebuilt srcset uses CDN URLs.

Images you translated by hand#

TranslatePress lets you set a different image for a language in its visual editor. It stores this as a pair of URLs: the original image URL and the translated image URL.

  • Translations saved before WP Media Cloud. The original URL was stored as a local URL. The page now outputs the CDN URL, so the stored pair no longer matches. The translated image does not appear.
  • Translated image picked before offloading. The translated value is a local URL. WP Media Cloud does not rewrite it, because TranslatePress adds it after rewriting has run. If you removed local files, that image breaks.

To fix either case, open the page in the TranslatePress visual editor, select the image, and set the translated image again. The Media Library now gives you CDN URLs, so the new pair matches.

What you need to switch on#

There is no TranslatePress setting in WP Media Cloud. Check these:

  1. Go to Media Cloud > Settings and make sure Rewrite URLs is on in the Offload Behaviour card.
  2. Offload existing media with Offload All Media in the Dashboard Bulk Offload card.
  3. Open Media Cloud > Integrations. The TranslatePress card in the Multilingual section shows Active. This status can take up to 5 minutes to update.

Troubleshooting#

What you seeWhat it meansHow to fix it
Translated pages show local image URLsRewrite URLs is off, the files are not offloaded, or a page cache holds old HTMLTurn on Rewrite URLs, run Offload All Media, then clear your page cache
A hand-translated image shows the original imageThe stored original URL is local and no longer matches the CDN URLSet the translated image again in the TranslatePress visual editor
A hand-translated image is brokenThe translated value is a local URL and the local file was removedSet the translated image again so it uses the CDN URL

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only