Skip to content Skip to sidebar
Home » WPML Documentation » Getting Started Guide » How to Translate Blocks with WPML

How to Translate Blocks with WPML

Tomer Helzer
Updated
October 22, 2025

Learn how to translate Gutenberg blocks, as well as Gutenberg-based plugins using WPML.

What Blocks Can WPML Translate?

WPML can translate any Gutenberg-based block plugin, including:

  • Kadence Blocks
  • GenerateBlocks
  • Ultimate Blocks
  • Essential Blocks
  • Otter Blocks
  • Stackable
  • Spectra

Regardless which plugin you use, the translation process is the same. 

Translating Blocks with WPML

To translate any block with WPML:

  1. Go to WPML → Translation Dashboard.
  2. Select the content containing your blocks. For instance, in our example we’re selecting a homepage built with Kadence Blocks. 
Selecting homepage with Kadence Blocks
Selecting homepage with Kadence Blocks

  1. Scroll down to Step 2 and choose a translation method. To get the best translations, choose the Translate automatically option.
Selecting Translate Automatically in Step 2
Selecting Translate Automatically in Step 2

By default, WPML uses its own AI translator, PTC (Private Translation Cloud), when translating automatically. Unlike traditional machine translation engines, like Google Translate or DeepL, PTC uses your entire website as context, creating highly accurate translations that don’t need to be reviewed. 

  1. Finally, choose whether you’d like to review translations and click the Translate button.  
Choosing Publish without review option
Choosing Publish without review option

Once WPML finishes translating your blocks, your translations will appear on your site when switching languages. For example, the heading, description, and two buttons in our homepage are now translated to French. 

Homepage with Kadence Blocks in English
Homepage with Kadence Blocks in English
Homepage with Kadence Blocks in French
Homepage with Kadence Blocks in French

Edit Translations (Optional)

While PTC’s translations are highly accurate, you can still edit them if needed:

  1. On your website, go to the translated page you want to edit. 
  2. Click the Edit translations button in the top admin bar.
Clicking the Edit translation button
Clicking the Edit translation button

  1. This will open the Advanced Translation Editor, where you can see your original content on the left, and translations on the right.
  2. To edit translations, click the translation you want to edit and make your changes. 
Editing translations for homepage heading
Editing translations for homepage heading

  1. When done editing, click the Complete translations button to save your changes. Your edits will now appear on your translated page. 

Translate Everything Automatically

Once you’re comfortable translating automatically, you can translate your entire website into more languages using the Translate Everything Automatically feature:

  1. Go to WPML → Translation Dashboard.
  2. At the top of the dashboard, click the toggle in the Translate Everything Automatically container. 
Enabling Translate Everything Automatically
Enabling Translate Everything Automatically

  1. In the pop-up that appears, choose what content you want to translate: Translate your entire site, or Translate only future content.
Choosing Translate only future content in the pop-up
Choosing Translate only future content in the pop-up

  1. Finally, choose whether you’d like to review completed translations and click the button to start translating. 
Clicking the Start Translate Everything Automatically button
Clicking the Start Translate Everything Automatically button

WPML will now automatically translate all the content on your website, indicating the progress at the top of the Translation Dashboard.

Frequently Asked Questions

Why do some of my texts appear untranslated?

If some of your texts appear untranslated, they are likely strings – pieces of texts that need to be translated separately. To translate strings: 

1. Go to WPML → Translation Dashboard.
2. Scroll down to the Other texts (Strings) section.
3. Search for your untranslated texts, select them, and send for translation. 

How can I translate blocks built with the Site Editor?

To translate blocks built with the Site Editor: 

1. Go to WPML → Translation Dashboard.
2. Scroll down to the Template or Template Part section. 
3. Select your items and send them for translation.

Can I create different page designs in each language?

Yes, you can create different page designs in each language. Follow our guide about creating unique designs per language for more information. 

Can I translate custom Gutenberg blocks?

Yes, follow our translating custom Gutenberg blocks guide for step-by-step instructions.