Universally Documentation

Step-by-step guides, multilingual SEO tips, and best practices to help you translate and scale your WordPress website.

Replace images by language

The Media screen lets you give an image its own version in each language, so Spanish visitors see a Spanish banner while everyone else sees the original. A replacement applies everywhere that image appears on the project, on every page, and you can make one by uploading a file or by having AI translate the text in the picture.

This page covers uploading your own image. For the AI route, see Translate text in images with AI.

Before you start

  • A plan that includes image replacement. The table below shows which plans do. Without it, the Media screen still lists your images, but nothing can be changed and visitors see the original everywhere.
  • Permission to edit translations on the project. Owners, admins and editors have it. Members can open Media and look, but not change anything.
  • A website project. App projects translate strings rather than pages, so they have no Media screen.
  • Visits to your translated pages. Images are listed only after a page containing them has been opened in another language.
Plan Image replacement
Free No
Starter Yes
Business Yes
Pro Yes
Growth Yes
Scale Yes

Find the image

  1. Open the project and choose Media in the sidebar.
  2. The Table view lists one row per image, with a column per language. A filled cell already has its own image; a + cell still shows the original.
  3. Type part of the file name into Search by file name, or narrow the list with the filters beside it: Status (All, Replaced, Not replaced), Replaced in a language, Shape, Min width and Min height.
  4. Switch to Gallery if you would rather browse thumbnails.

Replace an image for one language

  1. Click the image's row, or the + cell under the language you want. A panel opens with the original at the top and one row per language under Languages.
  2. Drop your file on the language's row, or click the box on the right of the row and choose a file. PNG, JPEG, WebP and GIF files up to 5 MB are accepted.
  3. The change saves straight away and the row reads Own image. A toast confirms it with Undo, and, when other languages still show the original, a Use for N more action that gives them the same file.

If your file is a different shape from the original, the row shows Different shape. You can keep it, but it may look squashed or cropped on the page, so a file with the original's proportions is the safer choice.

Remove a replacement

  1. Open the image and find the language's row.
  2. Open the row's three-dot menu and choose Remove.
  3. Confirm with Remove, or choose Keep to leave it.

Visitors in that language see the original again. The toast offers Undo for six seconds.

Replace from the Visual Editor

In the Visual Editor, click any image on the page. The same panel opens beside the preview, with the language you are previewing listed first, and a change for that language is swapped into the preview without a reload. See Visual Editor.

What changes on your pages

For each translated page, Universally swaps the image's address for your replacement:

  • src and the lazy-loading attributes data-src and data-lazy-src.
  • srcset, data-srcset and data-lazy-srcset. An uploaded image is served resized, so these list widths from 480 to 1600 pixels.
  • <source> elements in a surrounding <picture> are removed, since the browser would otherwise pick one of them over your replacement.
  • Share images in og:image, og:image:url, og:image:secure_url and twitter:image, when they point at the same file.

In JavaScript mode the script makes the same swaps in the browser, including on images added to the page after it loads.

Replacing an image uses no translated words. Saving a replacement clears Universally's cached copy for that language, so the next page load shows it unless your own page cache or CDN still holds an older copy. See When changes go live.

For which images can be replaced at all, see Translate images and media.

Verify it worked

Open a page with the image in the language you changed, in a private window. The new image appears in place of the original, and in other languages the original is unchanged.

If it does not work

  • The image is not on the Media screen. It has not been seen on a translated page yet, or it is not one Universally can replace: images on other domains and CSS backgrounds are never listed. Open a page containing it in another language, then reload Media.
  • The banner says Image replacement is not on your plan. Your current plan does not include it. Replacements made before a downgrade are kept, but they are not shown to visitors and cannot be changed until you upgrade. See Plans and pricing.
  • The banner says Image replacement isn't available for this site yet. The project does not have its own translation storage, which replacements need. Contact support.
  • The page still shows the original. A page cache or CDN is serving an older copy, or the element is inside a selector you excluded in Translation Rules, where images are left alone. See Clear cache and refresh translations.
Was this helpful?