Translating Gutenberg Blocks: A Step-by-Step Guide

translate-gutenberg
TL;DR · Quick Summary
  • Learn how to translate Gutenberg blocks in WordPress using Linguator for multilingual websites efficiently.
  • Choose between manual and automatic translation methods based on your website's content needs.
  • Translate third-party Gutenberg blocks by configuring supported blocks through Linguator settings.
  • Review translated content, formatting, links, and layouts before publishing multilingual Gutenberg pages.

Gutenberg makes it easy to build WordPress pages using individual content blocks. But when you want to create a multilingual WordPress website, translating every heading, paragraph, button, image, and custom block manually can quickly become time-consuming.

You don’t need to recreate your Gutenberg pages from scratch for every language. With the right WordPress translation workflow, you can translate Gutenberg pages and blocks while keeping the original page structure and content organized.

In this guide, we’ll explain how to translate Gutenberg blocks, including manual translation, automatic translation, and how to handle third-party or custom Gutenberg blocks using Linguator.

Why Translate Gutenberg Blocks?

A multilingual website allows you to provide your content to visitors in their preferred language. This can help businesses, bloggers, agencies, and online stores reach audiences in different countries.

However, manually recreating and translating every Gutenberg page can take a significant amount of time, especially when a website contains dozens or hundreds of pages.

Using a WordPress translation plugin can simplify this process by allowing you to create language-specific versions of your pages and translate their content from the WordPress dashboard.

Linguator supports Gutenberg and allows you to translate Gutenberg pages either manually or automatically. It can also handle content inside supported third-party blocks.

How to Translate Gutenberg Blocks in WordPress

There are two main approaches to translating Gutenberg content with Linguator:

  1. Manual translation
  2. Automatic translation

Let’s look at both methods step by step.

Method 1: Manually Translate Gutenberg Blocks

Manual translation is useful when you already have professionally translated content or want complete control over the wording of your translated pages.

Step 1: Open Your WordPress Page or Post

From your WordPress dashboard, go to Pages or Posts.

Find the Gutenberg page or post you want to translate and click Edit.

Step 2: Open the Language Settings

Inside the Gutenberg editor, access the Languages settings from the sidebar.

You will see the languages configured for your website.

Step 3: Add the Translation

Click the “+” icon next to the language you want to create.

Linguator will open a new Gutenberg editor window for that language.

Step 4: Add Your Translated Content

You can now manually rewrite or paste the translated content into the Gutenberg editor.

You can translate the content inside your:

Make sure the translated version communicates the same meaning as the original content.

Step 5: Publish and Preview

Once you have finished translating the page, click Publish.

Then preview the translated page to make sure the content and layout look correct.

Manual translation gives you maximum control over the final wording, which can be especially useful for professional, legal, technical, or brand-focused content.

Method 2: Automatically Translate Gutenberg Blocks

If your website contains a large amount of Gutenberg content, automatic translation can save considerable time.

Linguator allows you to automatically translate Gutenberg pages using supported translation providers.

Here’s how the process works.

Step 1: Open the Gutenberg Page

Go to WordPress Dashboard → Pages or Posts.

Open the page or post you want to translate.

Step 2: Select the Target Language

Open the Languages settings from the page editor sidebar.

Choose the language into which you want to translate the page.

For example:

English → Spanish

Step 3: Duplicate the Original Content

A prompt will appear asking whether you want to duplicate the original page content.

Select Yes.

This creates the translated version based on the existing page.

Step 4: Select a Translation Provider

Linguator will display a Select Translation Provider option.

Choose your preferred translation provider from the available options.

Depending on your Linguator setup, supported automatic translation options include services such as Google Translate and browser-based AI translation. Linguator’s current documentation also lists Google Gemini AI among its translation options.

Step 5: Start the Translation

After selecting the provider, Linguator displays the source content and translation content.

Step 6: Update the Translated Page

Once the translation is complete, click Update Content.

The translated Gutenberg page is then created in the selected language.

Step 7: Review the Translation

Automatic translation can save significant time, but it is still important to review the result before publishing.

Check:

  • Headings
  • Paragraphs
  • Buttons
  • Links
  • Images
  • Captions
  • Formatting
  • Overall meaning
  • Grammar and terminology

You can manually edit the translated content whenever necessary. Linguator’s documentation specifically recommends previewing the translated page and making manual edits where needed.

How to Translate Third-Party Gutenberg Blocks

Not every Gutenberg block comes from WordPress itself.

Many websites use third-party Gutenberg block plugins to add advanced layouts and components. These plugins can introduce custom blocks that may not be detected automatically during translation.

For example, a website might use a timeline, advanced gallery, testimonial, pricing table, or other custom block.

In these situations, you may need to enable the block for translation in Linguator.

Step 1: Find the Custom Block

Open the Gutenberg page containing the third-party block you want to translate.

Start the translation process and check whether the block’s content has been translated.

If the standard Gutenberg content is translated but the third-party block remains in the original language, the block may not yet be enabled for translation.

Step 2: Open Supported Blocks

From your WordPress dashboard, go to:

Linguator → Settings → Supported Blocks

Use the search box to find the block you want to translate.

For example, you could search for a block such as Timeline.

Step 4: Copy the Block Text

Click Copy Text and paste the copied text into the appropriate section of the block configuration.

Then click Save.

Step 5: Translate the Page Again

Return to the Gutenberg page and select your target language.

Start the translation process again.

Once the block has been configured correctly, Linguator can translate the Gutenberg content along with the supported third-party block content.

Automatic vs. Manual Gutenberg Translation

Which translation method should you use?

It depends on your website and workflow.

Manual translation is ideal when you need complete control over every sentence or already have professional translations available.

Automatic translation is useful when you need to translate a large amount of content quickly and want to reduce repetitive manual work.

auto-vs-manual

For many websites, a combination of both approaches works best: automatically translate the initial content, then manually review and refine the most important pages.

Linguator supports both manual and automatic Gutenberg translation, allowing you to choose the workflow that fits your website.

Best Practices for Translating Gutenberg Content

Translating a page is only the first step. Before publishing the translated version, follow these best practices.

Review Automatic Translations

AI and machine translation can significantly speed up the process, but always review important content for accuracy, tone, and context.

Keep Your Terminology Consistent

Product names, brand names, technical terms, and important phrases should remain consistent across your translated pages.

Check Buttons and Links

A translated button should still communicate a clear action. Also check that links point to the correct language version of the destination page where applicable.

Check Your Layout

Translated text can be longer or shorter than the original. Preview the page on desktop and mobile to make sure headings, buttons, columns, and other elements still look correct.

Check Third-Party Blocks

If you use custom Gutenberg blocks, make sure their content has been translated. If it hasn’t, check the supported block settings in Linguator.

Why Use Linguator to Translate Gutenberg Pages?

Translating Gutenberg content manually can become difficult as your website grows.

Linguator provides a dedicated multilingual workflow inside WordPress and supports both Gutenberg and Elementor. It can translate pages and posts automatically or manually, while also supporting bulk translation, custom post types, taxonomies, media metadata, language management, and RTL languages.

This makes it possible to manage multilingual content from your existing WordPress dashboard rather than maintaining separate websites for every language.

For websites with a large amount of content, Linguator also provides bulk translation for multiple pages, posts, categories, and taxonomies.

Frequently Asked Questions

Can Gutenberg blocks be translated in WordPress?

Yes. Gutenberg pages and their content can be translated into different languages using a WordPress multilingual or translation plugin such as Linguator.

How do I translate Gutenberg blocks?

You can manually create a translated version of your Gutenberg page or use automatic translation. With Linguator, select the target language from the Languages settings and choose your preferred translation method.

Can I automatically translate Gutenberg pages?

Yes. Linguator supports automatic translation of Gutenberg pages using available translation providers. After translation, you can review and manually edit the content before publishing.

Can custom Gutenberg blocks be translated?

Yes, but some third-party blocks may require additional configuration. If a block isn’t automatically translated, go to Linguator → Settings → Supported Blocks, add the block, save its configuration, and run the translation again.

Can I manually edit an automatic Gutenberg translation?

Yes. After automatic translation, you can preview the translated page and manually edit the translated content to improve accuracy, terminology, or style.

Is Linguator compatible with Gutenberg?

Yes. Linguator supports Gutenberg as well as Elementor and allows you to translate content created using these editors.

Conclusion

Translating Gutenberg blocks doesn’t have to mean rebuilding every page manually.

With Linguator, you can create translated versions of Gutenberg pages, choose between manual and automatic translation, and review the translated content before publishing. If you’re using third-party Gutenberg blocks, you can also enable supported custom blocks through Linguator’s settings and translate their content.

For small websites, manual translation may be enough. For larger multilingual WordPress websites, automatic translation can significantly reduce repetitive work while still allowing you to review and refine the final content.

If you want to translate Gutenberg blocks and build a multilingual WordPress website from a single dashboard, Linguator provides the tools to get started.

Share This Post...
Table of Contents