Skip Navigation
Home » Documentation » Plugins Compatibility » How to Build Multilingual Sites with Oxygen and WPML

How to Build Multilingual Sites with Oxygen and WPML

Dario
Updated
October 10, 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

Oxygen Builder is not currently compatible with WPML. The only option for translating pages built with Oxygen Builder is to translate them manually.

To do this:

  1. Edit the default language page you want to translate.
  2. In the sidebar, turn off WPML’s Translation Editor for this page.
Turning of WPML’s Translation Editor
  1. Click the plus icon to add a translation.
Adding a translation
  1. This creates a new page in your secondary language. You can either copy over the content from your default language, then translate it in the Oxygen Builder, or save the page and open the Oxygen Builder to create a new design from scratch.
Options for creating the translated page

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 WPML → Settings 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.

Buy and Download