WPBakery page builder is one of the most popular WordPress page builders. It allows you to build your pages in a visual way, using its intuitive drag-and-drop interface. It is also bundled with many popular themes.
- Getting Started
- How To Translate WPBakery Pages Using WPML
- All the Current Translatable WPBakery Page Builder Modules
- Adding Support for the Raw HTML Element
- Maintaining the WPBakery Page Builder Compatibility With WPML
- Known Issues with WPBakery
Start by installing and activating the following plugins:
- WPBakery page builder plugin
- 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.
WPBakery is compatible with WPML’s Translate Everything mode. If you choose this mode when setting up WPML, all of your WPBakery page content will be automatically translated as you add or edit it.
If you want to decide yourself which of your content gets translated, choose Translate Some mode when you set up WPML.
To translate your site’s content using the Translate Some mode:
- On your list of pages, click the plus icon under the language and next to the page that you want to translate.
- You’ll be taken to WPML’s Advanced Translation Editor. You can choose between automatically translating your content or manually inputting the translations for each sentence.
- Click Complete once you’re done with all your translations.
You should now be able to view your default language and secondary language pages on the front-end.
Page in default language
Page translated to Polish
You can find detailed explanations of both translation methods in our documentation about translating page builder content.
WPML supports translating text in the WPBakery Page Builder modules:
- Text Block
- Separator with Text
- Message Box
- Hover Box
- Single Image
- Image Gallery
- Image Carousel
- Pageable Container
- Custom Heading
- Call to Action
- Widgetised Sidebar
- Posts Slider
- Video Player
- Google Maps
- Flickr Widget
- Progress Bar
- Pie Chart
- Round Chart
- Line Chart
- Post Grid
- Media Grid
- Post Masonry Grid
- Masonry Media Grid
- Tweetmeme Button
- WP Search
- WP Meta
- WP Recent Comments
- WP Calendar
- WP Tag Cloud
- WP Text
- WP Recent Posts
- WP Categories
WPML allows you to manually enable the translation of the Raw HTML element.
Enabling the translation of the Raw HTML element might cause issues when sending a page to professional services or using the Advanced Translation Editor locally to translate it. The issue is not technical, but stems from the fact that translators often do not, understandably, understand the code and can break it during translation.
To translate the texts in the Raw HTML element, you must add them to the Custom XML Configuration tab found on the WPML → Settings page. Here is the code snippet:
<wpml-config> <shortcodes> <shortcode> <tag encoding="base64">vc_raw_html</tag> </shortcode> </shortcodes> </wpml-config>
Read more about registering page builder modules for translation.
We have prepared a developer’s documentation that explains how the WPBakery Page Builder works with WPML. Read more about updating the language configuration file to maintain the compatibility between WPML and WPBakery Page Builder.
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.