Skip Navigation
Updated
October 11, 2021

The WordPress default editor is called Gutenberg or the Block Editor. WPML is fully compatible with Gutenberg, making it easy to translate content built with it.

Using the Gutenberg Block Editor in Multilingual Sites

With Gutenberg, you use elements called blocks to build content visually.

Building page with Gutenberg blocks

Check out this WordPress Gutenberg tutorial for more information on how to build a site using the Gutenberg editor.

The following video shows how simple it is to translate a specific page yourself using the Advanced Translation Editor:

Translating Content Created Using Gutenberg

Creating content with Gutenberg is easy, and WPML offers several options to translate it:

Getting Started

First, you need to install the main WPML core plugin, which contains the Translation Management feature. This feature is only available for WPML Multilingual CMS and WPML Multilingual Agency accounts.

If you have the WPML Multilingual Blog account, you can only translate your content using manual translation.

Translating Your Whole Site Automatically

WPML allows you to translate your entire site automatically using the Translate Everything mode. This includes posts, pages, and custom post types created with Gutenberg, and any taxonomy terms assigned to them.

To enable Translate Everything mode, you can either choose it when going through the setup wizard, or choose it from WPMLSettings. You can also choose if you want to review the translations before or after you publish them.

Choosing Translate Everything Mode in the Setup Wizard

Choosing Translate Everything Mode in WPML → Settings

Once you select it, your content will immediately start to translate. You can monitor the progress on the Translation Management Dashboard.

Viewing the status of your automatic translations

Sending for Translation

When working with your own local translators or a translation service, you simply send the content for translation using the WPML Translation Management page:

  1. Select the content to send for translation.
  2. Select the languages you want to translate into.
  3. Click to add selected content to the Translation Basket.
Choosing the pages you want to send for translation
  1. Go to the Translation Basket tab and click to send selected content for translation.
Sending translation jobs to translators

That’s it! When translators finish the job, it will be available in your site.

At any time, you can check if there are finished translations and apply them to your site. To do this, go to the WPML Translation Management page and click the Check status and get translations button.

Translating the Content Yourself

If you are the site’s only translator you can start translating any page in two ways:

  • Edit the page and in the Gutenberg editor’s sidebar, open the Language section. There, click the Plus icon next to the language you want to translate this page into.
  • Go the list of Posts, Pages, or custom posts and click the Plus icon next to the language you want to translate this page into.
The Plus icon when editing a page
The Plus icon when viewing the list of posts

In both cases, you then go to the Advanced Translation Editor, where you can translate the page’s texts.

Translating content using WPML’s Advanced Translation Editor

Manual Translation

If you have the WPML Multilingual Blog account, you don’t have access to the Translation Management feature that allows you to send content for translation or use the Advanced Translation Editor.

In this case, you can only use manual translation for your Gutenberg-designed content:

  1. Create or edit the page in the default language.
  2. Click the Plus button in the Language section of the Gutenberg editor’s sidebar.
  3. Recreate the same page in the secondary language.
Creating the page again in the secondary language

Translating Reusable Blocks

WordPress Block Editor allows you to save any content block and reuse it later in other pages. WPML allows you to easily translate these reusable blocks.