Nested Paragraphs translation

Looking back, translating content in Drupal 7 wasn't a straightforward task. It involved enabling a number of modules to do all the translations properly. And in Drupal 8, the Multilingual Initiative took big steps forward to enhance multilingual support for users.

Since its introduction in May, 2011, huge efforts by everyone involved resulted in hundreds of issues resolved and many great improvements have since been made that now drastically simplifies the site building process.

Nested paragraphs in Drupal 8

However, basic Drupal content management can be extended with many modules. One of the most popular is Paragraphs. Instead of putting the content in one WYSIWYG body field, it lets users choose between predefined Paragraph Types. These can be anything from a simple text field to a combination of images, text, videos and slideshows. You can read more details about this module in this great blog post by Kathryn McClintock.

We are extensively using Paragraphs at Amazee Labs for our content-rich websites and opted for its use for our first fully-decoupled Drupal project as well.

Paragraphs in Drupal 7 currently lacks support for Entity Translation. However, this has been successfully implemented in its new iteration and I personally contributed in this process. The translation process is not as straightforward as translating basic nodes or other entities and users are still facing many issues. For a better understanding of the topic, a community documentation page for Paragraphs Multilanguage constraints was created on

This page covers only the basic setup and some general constraints. But how do we set it up for complex projects, with many levels of nested paragraphs? Let’s recap the basics first and dig deeper in nested paragraph translation a bit later.

Basic rules

The Paragraphs module works within a multi-language setup but there are crucial steps in order to achieve the correct functionality. We can split the set up into two parts:

  • Site building:

    • Translatable paragraph fields on the parent entity are not supported (e.g. Node, Taxonomy term, etc.)

    • Disable translation on an Entity Reference revision field either inside a Content type or Paragraph (untick Users may translate this field)

  • Content language and translation UI:

    • Disable translation on an Entity Reference revision field (where it says (* unsupported))

    • Enable the translation on every Paragraph


That being said, let’s look at an example of the correct and incorrect way to enable translatable paragraphs.

The first point says that whenever we create a field that holds paragraph elements on the first level - on a content type, for example, should not be translatable. The example node, in this case, contains a Content field (field_landing_page_content) which is a reference to many other Paragraphs, like Gallery and Accordion. This field must NOT be set to translatable - “Users may translate this field” should be unchecked!

Entity references fields should not be translatable

Instead, only Paragraph types that contain content fields, like links, texts or images need to be set to translatable, because this fields itself need to be translated.

To activate the multi-language functionality you need to go to: admin/config/regional/content-language. This step is crucial when dealing with nested Paragraphs. In our case we use a structure with 3 levels of paragraphs that looks like this:

- 1st Level Page (Node)

- - Content (Entity reference revisions field, not translatable)

- - - Section (Paragraph, has Entity reference revisions field Content with Accordion Paragraph and others)

- - - - Accordion (Paragraph, has Entity reference revisions field Accordion container with different accordion paragraphs)

- - - - - Simple Accordion Item (Paragraph, has Entity reference revisions field Content with different content paragraphs)

- - - - - - Title, Text, Video, Gallery etc. (Paragraph, text, link and Entity reference (media) fields)

As a first step here, make sure Paragraph is checked.

Paragraph is checked

Under the 1st level page, the content should NOT be set to translatable. The Paragraphs module is smart enough to warn us about the Entity reference revisions fields being currently unsupported (there is a big meta ticket about this topic on d.o.).

Content should NOT be translatable.

Next, we need to dig into the fun part - the Paragraph section. Let’s look at the example mentioned above. Every Paragraph should be set translatable.

First level of nested paragraphs

At least one field should be selected in order for a Paragraph to be translatable. If the Paragraph has only one field, which is of type Entity reference revisions (a linking Paragraph), we need to check some of the default text fields.

Second nested paragraph

Here we want to translate specific text fields as usual.

Third nested paragraph

Saving this configuration should get you up and running and ready to go. Happy Paragraph translating!

June 30, 2017

Get our Newsletter



Its not works. Paragraph add remove button is also not showing in translated page.

By Ujjal Ghosh
7 months ago

Thanks a lot! Tested and confirmed. In the end it even sounds logical, although it was not obvious on the first glance.

By Norman
5 months ago

Hi, I am using Drupal 8.4.4 and I have tried with the dev version of paragraph and 8.x-1.2 and with both even if I see the translation correctly in the edit page when I save the page, I see always the default language of the paragraph fields.
In the "admin/config/regional/content-language" in the Paragraph Type I have selected in the Default language "Interface text language selected for page", in your pictures I see "Content language selected for page" but I guess that is a older version.

Any idea of what is wrong? I have tried with a view, and selecting "Interface text language selected for page" I see the correct language.

By Isabel
4 months ago

Sorry, it had nothing to do with the paragraph configuration, it is a problem with the panel module, I will write again when I find a clearer idea of what happens.

By Isabel
4 months ago

Add new comment

You must have Javascript enabled to use this form.
What is Amazee Labs?