Universally translates the text that describes your media: alt text, titles and captions are translated in every language. The image file itself stays the same unless you give it a replacement for a language, by uploading your own version or by having AI translate the text in the picture.
Video, audio and CSS background images are never changed, so keep translatable text in HTML wherever you can. Text inside an inline <svg> is translated like any other text.
What gets translated
Image alt text
The alt attribute on <img> tags is automatically translated. This is important for both accessibility (screen readers) and SEO (search engines use alt text to understand images).
<!-- Original -->
<img src="/hero.jpg" alt="Team working together in the office">
<!-- Translated (Spanish) -->
<img src="/hero.jpg" alt="Equipo trabajando juntos en la oficina">
Title attributes
The title attribute on any element (images, links, etc.) is translated. This is the tooltip text that appears when hovering over an element.
<!-- Original -->
<img src="/chart.png" title="Quarterly revenue chart">
<!-- Translated (German) -->
<img src="/chart.png" title="Vierteljährliches Umsatzdiagramm">
Open Graph image alt
The og:image:alt and twitter:image:alt meta tags are translated so that social media previews display accessible image descriptions in the correct language.
Image captions
Any text rendered in HTML near images, such as <figcaption> elements, caption paragraphs, or overlay text, is translated as normal page content.
What is not changed
Image files, unless you replace them
By default the image source (src) is not modified, so the same file is served in every language and text baked into it, such as a banner reading "Welcome", stays in the original language.
On a plan that includes image replacement, you can give an image its own version per language from the Media screen. See Which images can be replaced below.
Video and audio
Video sources, audio files, and embedded media (YouTube, Vimeo, etc.) are not modified. Subtitles or captions embedded in video players are not translated.
Background images
CSS background images are not affected. Any text baked into background images remains in the original language.
Text drawn as paths, or in an external SVG
An SVG referenced as a file, and lettering drawn as paths rather than as text, cannot be translated. Move that text into HTML over the graphic if it needs to change per language.
Text inside an inline <svg> is a different case: where the SVG carries a <text> element, its words are translated like any other text on the page, and the markup, paths and attributes around them are left alone. Add class="notranslate" to the <svg> if it must stay in the source language.
Which images can be replaced
Universally collects the images it can replace from your translated pages:
<img>elements in the page body. The image is identified by itssrc, or bydata-srcordata-lazy-srcwhensrcis missing or a placeholder.- Share images in
og:image,og:image:url,og:image:secure_urlandtwitter:image.
Only images on your site's domain or one of its subdomains count. Images served from other hosts, such as avatars or a third-party CDN, are never listed or swapped. Inline data: images are skipped too.
An image's identity is its full address, including any query string, so banner.jpg?v=2 and banner.jpg?v=3 are two different images. A replacement applies wherever that exact address appears on the project, and images inside a selector you excluded are left alone.
Images are listed on the Media screen after a page containing them has been opened in another language. To replace one, see Replace images by language or Translate text in images with AI.
Best practices
Use glossary rules for brand imagery descriptions. If your alt text contains brand terms that should stay in English (e.g., “MacBook Pro on a desk”), add a Keep glossary rule for the brand name. See Glossary rules.
Avoid text in images where you can. HTML text over an image is translated with the page and read by search engines. When the text has to be part of the picture, replace the image per language.
Always include alt text. Every meaningful image should have an alt attribute. Universally translates it automatically, improving accessibility across all languages.
Use captions in HTML. Wrap image captions in <figcaption> or similar HTML elements rather than placing them inside the image itself.