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 want a multilingual site, Divi’s integration with WPML will allow you to translate all the theme elements effortlessly.
Divi page in original content
Divi page translated to French
On This Page:
- Getting Started
- Translating Project Pages and Categories
- Translating Texts From Divi Theme, Plugins and Other Places
- Translating Divi’s Custom Layouts
- Translating Divi’s Global Modules, Rows, and Sections
- Translating Divi’s Custom Global Header and Footer
- Adding Support for Divi Builder Modules & Other Divi Add-Ons
- Maintaining the Divi Builder Compatibility with WPML
- Known Issues with Divi
- Getting Help From Our Support
- Get Help With Building and Maintaining Your Site
- Get WPML
Start by installing and activating the following:
- Divi theme
- WPML core plugin and WPML String Translation add-on
If you’re new to WPML, check out our Getting Started Guide. It quickly walks you through different translation options you can use.
These translation options include Translate Everything Automatically, which when turned on, automatically translates all of your site’s main content. This guide is based on not having this setting activated and instead, using WPML’s Advanced Translation Editor for automatically translating content.
To translate Projects or any custom post type items, you need to follow the same steps as for translating any other types of pages or post types.
You can translate your Project Categories on the WPML → Taxonomy Translation page. Select the Project Categories from the drop-down menu and a list of your categories will appear. Click the plus icon to translate a category for the respective language.
Keep in mind that the translations of categories are universal: if you make a change, they will be updated everywhere.
Besides content coming from posts and pages on 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.
With Divi, you can create your own layouts and save them to be used in different pages or posts. Check Divi’s documentation on saving and loading custom layouts. These layouts can be translated using WPML. You can even have different layouts for each language on your website.
Follow the same steps of translating posts, pages, and custom post types to translate Divi’s custom layouts.
When translating a page or post that uses a layout template that you have already translated, WPML automatically preloads the translated content in the Advanced Translation Editor.
With Divi Builder, you can set a module, row, or section to be global. This adds it to your Divi library and you can insert it into any page. Updating any instance of the global item will update all of the items inserted into different pages.
Follow the same steps for translating posts, pages, and custom post types to translate Divi’s global modules, rows, and sections.
When translating a page or post that uses a global item that you have already translated, WPML automatically preloads the translated content in the Advanced Translation Editor.
Divi’s Theme Builder allows you to create a custom global header, body, and footer.
Before you proceed with translating header, body, or footer layouts, we highly recommend that you give your layouts a descriptive name. This makes it easier to distinguish which layout you want to translate on the Translation Management page.
You can do this while editing your layout by navigating to the Layout Settings box and adding a descriptive name in the Title field.
To translate the Divi site header or footer you created using the Divi Theme Builder, follow these steps:
- Go to WPML → Translation Management. and use the Type dropdown to filter for Header Layout, Footer Layout, or Body Layout.
- Choose which headers or footers you want to translate.
- In translation options, select the option to Translate your template.
- Choose between translating your global header or footer automatically or by yourself. If you’re the only translator on the site, you’ll see a button called Add to Translation Queue. If you added translators or a professional translation service to your site, the button says Add to Translation Basket.
- If you are translating by yourself, go to WPML → Translations to take and translate the global header using the Advanced Translation Editor.
If you’re working with other translators or a professional translation service, go to the Translation Basket tab, select who should translate the header or footer, and click to send items for translation.
This is how the translated header looks like on the front-end:
WPML allows you to manually enable the translation of additional Divi Builder elements, element attributes, and add-ons that enhance its usability.
To make these translatable, please see our documentation about how to register page builder modules.
Enabling the translation of some elements/element attributes might cause issues when sending a page to professional services or using a local translator. The issue is not technical, but stems from the fact that translators often do not, understandably, have in-depth code knowledge or experience.
We have prepared documentation that explains how to maintain Divi builder compatibility with WPML. It explains the process of updating the language configuration file.
Current unresolved issues:
- WPML SEO – Issue with Divi Theme and Transient Cache Settings for Yoast SEO Sitemaps
- Divi – Button Apostrophes display as HTML entities
- Divi – Global Footer Translation is not displayed upon changing the default language
- Divi or Elementor – Product Category Archive Template Not Applied to Translated Category Archive
- Divi – Sticky links aren’t converted to permalinks when used in Divi theme builder
- “A different domain per language” URL configuration conflicts with the Divi Back-end Builder
You can also search all known issues including previously resolved issues for this theme.
In case you need help translating your site built using Divi and WPML, visit WPML’s support forum.
If you need help with building or maintaining your site, take a look at our list of WPML Contractors. They are experienced developers of multilingual sites.
You can test WPML for 30 days to see if you like it.
If you are not happy with our plugin during this period, we will refund you without any questions.