WPML supports translating pages and posts created using the native WordPress blocks along with custom blocks coming from Gutenberg blocks plugins. Learn how to translate these pages.
- Getting Started
- Translating Content Created With Gutenberg Blocks Plugins
- Updating Blocks Translations
- WPML-Compatible Gutenberg Blocks Plugins
- Getting Help
Start by installing and activating:
- WPML core plugin and WPML String Translation add-on
- Any additional Gutenberg blocks plugins you wish to use
If you’re new to WPML, check out our Getting Started Guide. It quickly walks you through all the translation options you can use.
One of these options is Translate Everything – the quickest way to translate and the easiest way to keep your content up to date. This feature automatically translates pages, posts, custom post types, custom fields, taxonomies, WooCommerce products, and more as you add and edit content.
WPML supports translating pages created using the native WordPress blocks along with the custom blocks coming from Gutenberg blocks plugins. Whether you are creating your pages using native WordPress blocks, custom Gutenberg blocks, or a mixture of both, you will be able to translate these pages using WPML.
Furthermore, if you have WPML’s Translate Everything turned on, the translation of your content will be automatically taken care of. If you choose to have this feature turned off, the below sections detail how to translate manually.
This is a simple page that we created using native WordPress blocks along with custom blocks from the Kadence Blocks plugin.
To translate this page, follow these steps:
- Go to the page editing screen. In the Gutenberg editor’s sidebar, open the Language section and click the plus icon next to the language you want to translate your page into.
- You are taken to the Advanced Translation Editor page. To load the machine translation, choose to Translate automatically. Review the translation and make sure it is accurate. Once done, click the Complete button to publish the translated page.
This is how the translated page looks on the front-end:
You can follow the exact same steps to translate pages and posts created using custom blocks supported by WPML.
If you update the text of a block in the original language or add new blocks to your page, you will see spinning arrows next within the language section of the sidebar. This indicates that you need to update the translation. In this example, we added text to one of the existing blocks on our page.
To update the translation, follow the steps below:
- Click the spinning arrows icon next to the language you want to update the translation for.
- This takes you to the Advanced Translation Editor. As you can see in the screenshot below, the existing translation is preserved. Review the translation of the added text and click the Complete button to update the translation.
- Toolset Blocks
- Kadence Blocks
- Ultimate Addons for Gutenberg
- PublishPress Blocks
- Stackable – Gutenberg Blocks
- Premium Blocks for Gutenberg
- Atomic Blocks
If your favorite Gutenberg blocks plugin is not listed, please feel free to ask the plugin developer to join our Go-Global program where we help developers make their themes and plugins multilingual ready, and compatible with WPML.
In case you need help translating your site built using Gutenberg blocks plugins and WPML, visit WPML’s support forum.