Skip Navigation
June 28, 2022

Oxygen is a visual page builder that enables you to design your whole site. Build advanced layouts with Oxygen and then translate the texts using WPML.

Please note that Oxygen Builder is currently not compatible with WPML. We reached out to their team to fix the current issues related to translating the content built using Oxygen.

If you need to use Oxygen with WPML, we suggest reaching out to their team and asking them to work with us on fixing the current issues. One of the ways of doing this is by upvoting and commenting on the open issue on the support page they already have for this.

Oxygen page in original content

Translating Oxygen pages with WPML

 Oxygen Page translated to French

Translating Oxygen pages with WPML

On This Page

Getting Started

Start by installing and activating the following plugins:

  • WPML core plugin and WPML String Translation add-on
  • Oxygen plugin

If you’re new to WPML, check out our Getting Started Guide. It quickly walks you through different translation options you can use.

Translating Oxygen Builder Pages

WPML offers different ways for you to translate pages built using Oxygen builder.

Let WPML Translate Everything For You

WPML’s Translate Everything mode can translate your site’s content automatically. This includes pages built with Oxygen. Any new content gets translated as soon as you publish it. Existing translations also get updated as soon as the content in the original language changes.

To make sure the automatic translations are good, you can review and adjust them as needed.

For more details, check out the page about translating your content automatically.

Translate the Content Yourself

You can also manually translate pages built with Oxygen Builder.

Edit the page in the default language and click the plus icon corresponding to the language you want to translate your page into.

Click the + icon to translate the page
Click the + icon to translate the page

Advanced Translation Editor screen will open. Fill in the fields with your translated content, mark them as completed, and save all the changes.

Send Content To Others To Translate

WPML allows you to send your content to translators. They work from a translation editor and only see text that requires translation.

For detailed steps, check out the page about sending content to translators.

List of Translatable Oxygen Builder Elements

WPML supports translating the below elements using the Advanced Translation Editor:

  1. Heading
  2. Text
  3. Text link (with no translation support for URLs)

Adding Translation Support for Oxygen Builder Elements

WPML allows you to add translation support for Oxygen Builder element’s shortcodes manually. This allows you to translate the content in these shortcodes.

You can define the element’s shortcode by adding it along with its attributes to the Custom XML Configuration tab on the WPMLSettings page. Check out our guide to learn more about defining page builder shortcodes.

Translating Oxygen Re-Usable Elements and Templates

Currently, WPML doesn’t support the translation of Oxygen’s Re-Usable elements and Templates.

However, you can use the following steps as a workaround for translating templates:

  1. Duplicate the default language template using a plugin such as Duplicate Page.
  2. Go to the editing screen of the template that you duplicated and edit it using the Oxygen builder.
  3. Add the translated text to the template and click Save.
  4. Translate the default language page.
  5. On the default language page editing screen, use the language switcher in the top admin bar to navigate to the secondary language editing screen.
  6. Choose the template that you translated in step 2. Make sure you select the actual template for each page and not the “Default” option.
Choosing the template that you translated
  1. Click to Update the page.

If you set conditions that determine which template to apply, please see this workaround provided by Oxygen.

Known Issues

WPML works fine with this plugin, but sometimes there could be minor issues we're working on. This is expected as both plugins provide frequent updates.

Current unresolved issues:

You can also search all known issues including previously resolved issues for this plugin.

Getting Help From Our Support

In case you need help translating your site built using Oxygen and WPML, visit WPML’s support forum.

Ready to get started?

Evaluate WPML for 30 days and see how you like it! If you are not happy with it, we will refund your money without any questions within the 30-day trial period.