Skip to main content

Documentation: Autolanguage plugin

YOOtheme Pro Builder Support

YOOtheme Builder pages are only available in the PRO version.
Unlock this and other features by upgrading to Joomill Autolanguage PRO

Go PRO
How YOOtheme Pro Page Builder Translation Works
If you build your Joomla articles or pages using YOOtheme Pro's page builder, your content is not stored as plain HTML — it is stored as JSON data embedded inside the article. This means a standard translation plugin would copy that JSON across as-is, leaving all your texts untranslated.

Autolanguage PRO handles this automatically.
When translating a YOOtheme Pro page, the plugin reads the JSON structure, identifies all translatable text fields inside it, sends only those texts to your chosen translation engine, and then writes the translated content back into a perfectly intact JSON structure. Your layout, styling, images and element settings remain completely unchanged — only the text is translated.

⚠️ Important: YOOtheme Pro translation requires Mode 1: Batch Translate to be active. The Translate upon Save mode does not support YOOtheme Pro builder content. Make sure you have selected Batch Translate mode in the plugin settings before translating YOOtheme Pro pages.


How to translate a YOOtheme Pro page

  1. Go to Content → Articles in your Joomla back end
  2. Select one or more articles built with YOOtheme Pro
  3. Click Actions → Translate in the toolbar
  4. Autolanguage PRO will detect the YOOtheme content and translate all supported fields automatically

Supported YOOtheme Pro fields

The following built-in YOOtheme Pro element fields & ZOOLanders Essential Addons fields are currently supported for translation:

title
meta
content
image_alt
link_aria_label
link_text
tags
message
author
footer
label
home_text
scale_x_title_text
scale_y_title_text
subtitle_text
title_text
dataset_label
metadata
email_subject
email_body
shared_text
shared_url
control_name
control_error_message
text

Need support for a 3rd party element?

Are you using a third-party YOOtheme Pro add-on or a custom element with fields that are not being translated? No problem — every add-on can define its own custom field names.

Just send me an email with the name of the add-on and, if possible, an example of the JSON output it produces. I will add support for those fields in an upcoming update.