WPML allows you to translate pages built with Divi. You simply need to create your page with Divi and then use WPML to translate the texts in your design.

Divi  Page in original content Divi Page translated to French
Translate divi with WPML Translate divi with WPML


Divi is a smart and flexible multipurpose theme, it comes with an easy to use page builder and a handful of pre-made layouts that will help you create the website that suits your needs. If you are willing to have a multilingual site, Divi’s integration with WPML will allow you to translate all the theme elements effortlessly.

What you will need

  • The Divi theme (version 3.0 or above).
  • A recent version of WPML (version 3.6.2 or above), including the String Translation, Translation Management, and Media translation add-ons.


Getting Started and What To Check

Is your site already configured by your developer?
Check with them to make sure that the core WPML plugins (WPML Multilingual CMS, WPML String Translation, WPML Translation Management) are installed. Also, make sure that the Divi theme is installed and activated.

Are you setting up WPML yourself?
Then you need to follow the steps below.

  • Set up WPML from WPML > Languages. See our WPML Getting Started Guide for a complete reference. The initial, simple three-step setup is self-explanatory, asking you to choose your default language, a set of active languages, and a language selector. (For starters, choose the footer language selector; you can change this later.)
  • Install and activate the core WPML plugins (WPML Multilingual CMS, WPML String Translation, WPML Translation Management) first, followed by other WPML plugins that may depend on them.
  • Install the Divi theme and activate it. Divi’s documentation will provide you with all the information needed to set it up and using its different features.
  • Activate the WPML Translation Editor. To do this,
  • Activate the WPML Translation Editor. Go to the WPML -> Settings page. There, check the Use the translation editor option under the How to translate posts and pages section and click Save.

Translating a page built with the Divi Builder (backend)

WPML allows you translate content in three ways. You can translate yourself, send content to your own translators or send jobs to a translation service.

Watch a short overview of translating and updating pages built with Divi in the following video:


Scenario 1: You do the translation yourself.

  1. Publish the page you just created with Divi. After publishing, the Language box will be displayed.
  2. Click the plus button for the language you wish to translate into.
    You can find these plus buttons in the Language box when editing your Divi page (in the back end), or on a listing page:
The plus located in the Language box when editing my Divi  page. The plus located under the flag in Pages -> All pages
Divi and WPML The + from the language box while editing a page Divi and WPML - the + from the listing pages

By clicking on one of these plus, you open WPML’s Translation Editor. Use it to translate the contents of your page and tick the box when the translation is complete as shown below:

WPML Translation Editor – Translating a page designed with Divi

When you’ve already translated, the plus icon changes to a pencil icon. Click on the pencil if you need to modify your translation.

WPML pencil icon to edit the translation with divi
The pencil icon replacing the plus if the translation is already made


Scenario 2: You want to send the pages to a translator.

WPML allows you to send your content to translators, directly from your WordPress dashboard. But first, you need to add translators to your site or to choose a translation service

You need to go to the WPML -> Translation Management page and select the content to translate (pages or posts).

Then, click to add the selected items to Translation basket.

Finally, on the Translation basket tab, you need to select translators that will translate the content.

The translators will be notified and they will translate on the WPML -> Translations page. The content will appear back in WordPress.

Translating a page built with the Divi Visual Builder (frontend)

In this part we will see how to switch from Divi Visual Builder to WPML Translation Editor.

  1. Create a Page and select Use Visual Builder

    translate divi with wpml
    Use the Visual Builder

  2. Design your page and Save it.

    Save your page

  3. Publish your page

    Design your page and add some Divi Modules

  4. Exit the Visual Builder

    Exit the visual builder

  5. Click on Edit Page, you will be redirected to your WordPress dashboard to do the translation

    Edit Page to access the translation

  6. Click on the plus in the Language box

    divi wpml
    The plus

  7. WPML Translation Editor will open

    WPML Translation Editor

  8. Fill in the fields and mark them as complete until you get 100% . Save and Close.

    Translation Complete

  9. In the front-end you see your Accordion translated:
Accordion in English Accordion in French

Updating a page and its translation

In this part we will see how to update your translation if you decide to modify the content of your page.

Scenario: I have added a new Module to my page and I need to translate it.

  1. Add a new Divi Module to your page. For this example it will be a Header Module.

    translate divi with wpml
    New Divi Module

  2. Click on Update.

    translate divi with wpml
    Always update the page

  3. In the Language box you see an arrow, not a plus anymore. The translation needs to be updated as you just added some new content to your English page. Click on the arrow to update the translation in French.

    translate divi with wpml
    The arrow

  4. You see WPML Translation Editor with new fields to fill in. Also note that the translation is back to 92%

    translate divi with wpml
    New Divi Module displayed in WPML Translation Editor

  5. Translate and mark all the translations as complete until you reach 100%. Save and Close.

    translate divi with wpml
    Translation completed


Always update your page in the Backend

Translating post categories, custom post types and custom taxonomies

In a similar manner, you can translate all other pages and posts, including the custom post types “Projects”. For example, here is how to translate a post:

  1. Navigate to “Posts” and click on the plus icon.
translate divi with wpml
The plus to translate a post

2.The Translation Editor will open again:

wpml translate divi
WPML Translation Editor scree when you translate a post, including the category

Translating post categories

  1. Navigating to Posts -> Categories, as an example we will create a category and name it “En-Category” and click on the Add New Category button.
  2. Click on the category that we have created.
  3. Click on the add link to add the translation of the category.

add tranalation to catagory

4. Fill the Name, Slug and Description fields with the category translation and click on the Add New Category button.

add translated content to the catagory

Translating custom post types (Project) and Project categories

The custom post type “Project” can be translated using the same steps followed to translate the regular post. Also, the post project categories can be translated in the same manner as we translated the regular post categories.

Translating custom taxonomies

  1. Go to WPML -> Taxonomy Translation
  2. Select Project Categories from the Select the taxonomy to translate drop-down menu.
  3. Click on the translate button to add the custom taxonomy translation by filling the required fields and then click on the “OK” button, as shown below.

Taxonomy Translation

Translating texts from Divi theme, plugins and other places

Besides contents coming from posts and pages in your site, there are usually some texts coming from other places. Most common examples are themes and plugins.

To learn how to translate these texts, read our documentation page about translating strings.

Translating Divi’s custom layouts

With Divi you can create your own layouts and save them to be used in different pages or posts. Check Divi’s documentation of Saving and Loading Custom Layouts. These layouts can be translated using WPML, you can even have different layouts for your languages. Follow these steps to create, save, translate and load your custom layouts:

  1. On your WordPress dashboard navigate to Divi > Divi Library and click on the add new button. Ensure that the main language switched in your WordPress dashboard is set to be your default language.
  2. Fill in the layout name and choose the Template Type: to be Layout

English LayoutCreate the layout structure that you prefer, in our example we will add a text module to the left and an image module to the right, then click on the Publish button:

translate divi with WPML
Publishing the custom layout

Again, click on plus in the language box:

Click the plus in the language box

The Translation Editor will open again with the Layout you just created:

WPML and Divi
WPML Translation Editor


When loading these layout templates to your pages, you can load the English layout to your English pages and the French Layouts to the French pages. This can be done by:

  1. adding a new page > Click on the Use Divi Builder button > Click in Load From Library tab.
  2. Click on the the Add From Library tab and click on the Load button to load the English layout.

Load English Layout template

The same steps can be followed to add the translated layout to your secondary language(s) page(s).

Translating Divi global modules, rows, and sections

Divi Builder offers setting a module, row or section to be global. This adds it to your Divi library and you can insert it into any page you want. Updating any instance of the global item will update all the items on different pages.

Translation support for global modules, rows and sections is featured in:

  • WPML Multilingual CMS (4.0.5 or above)
  • WPML String Translation (2.8.5 or above)
  • WPML Translation Management (2.6.5 or above)

We have created a simple page using the Divi Builder. The page includes a text module and a Call to action module we set as a global module.

Simple page using Divi Builder – Set a module to be global

To translate the global module follow the steps below:

    1. To translate the global module texts navigate to Divi -> Divi Library. Click the + icon to translate the global module in the desired language. This will take you to the Translation Editor page.
Navigate to Divi library and click on the + icon to translate the global module
    1. Enter the translated texts and select the Translation is complete check box. Once you complete translating the texts, click the Save & Close button.
Add you global module translated texts then Save & Close
    1. Navigate back to the content editing page where you have created the global module. Click on the + icon found in the language meta box to translate the page. This will take you to the Translation Editor page.
Click on the + icon to translate the page
    1. You will notice that the global module translated texts are preloaded into the translation fields. Add the translated texts for other elements on the page, tick the Translation is complete checkbox for each field and click Save & Close.
Translate the page texts and mark all the fields as Translation is complete

Let’s view the translated page on the front-end:

Translated page on the front-end

You can translate Divi’s global rows and sections following the exact same steps above.

Inserting a translated global module, row, and section to a page

You can insert the translated global module, row or section into any page on your website without worrying about translating its texts. Simply, click the + button to translate the page content. The translated global item texts will be preloaded in the Translation Editor page. Translate the texts for the rest of the page and mark all the translated fields as Translation is complete.

Updating/Editing the content of a global item

Editing global item texts in the default language requires updating the translation of the global item. We have updated the global item text in the default language page.

Update the global module text

To update the translation of the global module, follow the steps below:

    1. Navigate to Divi -> Divi Library. Click the spinning arrows icon to update the translation. This will take you to the Translation Editor page.
Click on the spinning arrows icon to update the translation
    1. WPML preserves the translated text. Simply translate the new texts you added, tick the Translation is complete check box, and Save & Close.
Translate the added text then save

This will update the translation of the global module in all the pages where the module is inserted.

List of the Divi Modules currently translatable by WPML

By “Divi Modules”, we include the ones located in the Divi Predefined Layouts and in the Full Width Sections.

The textual elements in the following Divi Modules are supported by WPML and will automatically be displayed in the Translator Editor screen and can be sent to professional translation services:

  1. Accordion
  2. Audio Player
  3. Bar counterBlog
  4. Blurb
  5. Button
  6. CTA
  7. Circle Counter
  8. Code
  10. Contact Form
  11. Countdown Timer
  12. Divider
  13. Email Optin
  14. Filterable Portfolio
  15. Gallery
  16. Image
  17. Login
  18. Map
  19. Number Counter
  20. Person
  21. Portfolio
  22. Post Navigation
  23. Post Slider
  24. Post Title
  25. Pricing Table
  26. Search
  27. Shop
  28. Sidebar
  29. Slider
  30. Social Media Follow
  31. Tabs
  32. Testimonial
  33. Text
  34. Toggle
  35. Video
  36. Video Slider

Adding support for more elements

WPML allows you to manually enable the translation of additional Divi Builder elements and element attributes.

We removed the list of attributes below from all the Divi Builder element, as they hold links to background images and videos. Removing these attributes won’t affect the translation workflow as they will be copied to the secondary language page(s) and are displayed on the front-end.

  1. background_image
  2. background_video_mp4
  3. background_video_webm

If you want to have different background image/video for a specific element, follow the steps below:

    1. Navigate to WPML -> Settings.
    2. Add the element short code and attributes to the Custom XML Configuration Tab. In our example we will add the background image and video attributes to the Call to action element.
Example - Call to action

This will allow the links to the image and video files to load into the Translation Editor page. You can translate them by linking to the secondary language image/video that you wish to add.

You can use the steps above to display the attributes of any element you want on the Translation Editor page.

You can find more information on the page about defining page builder shortcodes in the language configuration file.

Translating content coming from Divi add-ons

Divi has many useful add-ons and plugins that enhance its usability. While we are constantly working on expanding the support and the compatibility for these add-ons, not all of them are yet integrated with WPML.

In case of you run into a non-translatable add-on, we provide you with a workaround to manually integrate it with WPML. Follow the simple instructions provided on our page about integrating page builders that use shortcodes, with WPML.

Maintaining the Divi Builder Compatibility with WPML

We have prepared a documentation that explains how the Divi Builder works with WPML. Additionally, it explains the process of updating the language configuration file in order to maintain the compatibility between WPML and Divi builder. Feel free to check it here.

Getting help from our support

We have many supporters ready to help you in our WPML forum 6 days a week. They are trained on integrating WPML with Divi page builder.

If you are working with a developer for your site, please use our Translation support forum to get help with translating your site’s content.

If you are setting up the site and WPML yourself, please use our Technical support forum.

Need help with building and maintaining your site?

If you need help with building or maintaining your site, take a look at our list of WPML Contractors. They are experienced developers specialized in developing multilingual sites.

You don’t have WPML yet?

You can test WPML for 30 days and see if you like it.
If you are not happy with our plugin, we refund you without any questions in the 30 days.

Buy and Download