πŸ”Œ
Drupal

Drupal Paragraphs

The module that lets Drupal editors build pages from reusable components instead of one giant body field. Still the default for structured, component-based content.

Free
CMS: Drupal 9, 10, 11 PHP: 8.1+

Paragraphs is the module most Drupal marketing sites lean on for editor-friendly page building. Instead of one giant body field, you give editors a set of components (a hero, a text-and-image block, a call to action) that they add, reorder, and fill in. It has been around since Drupal 7 and it is still the default answer for structured, component-based content.

Paragraphs or Layout Builder?

This is the real decision, and most tutorials skip it. Paragraphs gives editors structured components inside a field; Layout Builder gives them free-form control over the whole page layout. If you want editors to assemble approved building blocks without touching the design, Paragraphs wins. If you need them to drag blocks into arbitrary regions and columns, Layout Builder fits better. Plenty of sites use both: Layout Builder for the shell, Paragraphs for the content inside it, or Layout Paragraphs to get drag-and-drop on top of Paragraphs.

Where Paragraphs bites you

Two places, mostly. Translation is fiddly because Paragraphs ride on Entity Reference Revisions, so multilingual sites need careful configuration or translations drift. And deep nesting has a real performance cost: paragraphs inside paragraphs inside paragraphs generate a lot of revision rows and entity loads. We keep nesting shallow and prune old revisions on sites that have run for years.

How we build with it

We treat Paragraphs as a locked-down component library. Editors get exactly the components the design supports, with sensible field validation, so nobody can break the layout by accident. When editors need to rearrange components visually, we add Layout Paragraphs. It plugs into the same theme work we do on Twig and Single Directory Components.

Once your Paragraphs content grows, people need to find it. That is where the Search API module comes in.

Key features

Reusable components

Define paragraph types (hero, text and image, CTA) once and let editors reuse them across the site.

Editor-controlled ordering

Editors add, remove, and reorder components without a developer and without touching the design.

Fieldable types

Each paragraph type is a real entity with its own fields, validation, and display settings.

Layout Paragraphs add-on

Pair it with Layout Paragraphs for drag-and-drop, multi-column editing on top of the same components.

An honest look at this plugin

We use this in real client projects β€” here's what we've learned.

βœ“ Strengths

  • +
    Structure without chaos β€” Editors get flexibility inside guardrails, so the design stays intact.
  • +
    Mature ecosystem β€” Layout Paragraphs, Paragraphs Library, and Bootstrap Paragraphs cover most needs.
  • +
    Actively maintained β€” Supported on Drupal 9, 10, and 11, so it is a safe long-term bet.

βˆ’ Weaknesses

  • βˆ’
    Translation is fiddly β€” Because it uses Entity Reference Revisions, multilingual setups need careful configuration or translations drift.
  • βˆ’
    Nesting has a cost β€” Deeply nested paragraphs generate many revision rows and entity loads, which hurts performance.
  • βˆ’
    Migrations are non-trivial β€” Moving Paragraphs content between sites or major versions takes real planning.

Our verdict

For component-based content that editors manage themselves, Paragraphs is still the default choice on Drupal. Reach for Layout Builder when editors need free-form page layout, and combine the two when you need each. Keep nesting shallow and plan translation up front.

Best for:

  • βœ“ Marketing and corporate sites where editors assemble pages from approved components
  • βœ“ Landing pages that change often and need consistent styling
  • βœ“ Editor-driven sites that must not let content break the design

FAQ

Paragraphs or Layout Builder?

Paragraphs for structured components editors fill in; Layout Builder for free-form page layout. Many sites use both. If your editors should assemble approved blocks without touching the design, start with Paragraphs.

Is Paragraphs still maintained for Drupal 11?

Yes. It is actively maintained and supported on Drupal 9, 10, and 11, so it is a safe long-term choice.

Does Paragraphs slow down my site?

Only when you nest it deeply. Each level adds revision rows and entity loads. We keep the component tree shallow and prune old revisions, and performance is a non-issue.

Can editors reorder components themselves?

Yes, out of the box. Add Layout Paragraphs and they get drag-and-drop with multi-column layouts.

How hard is translation with Paragraphs?

Manageable, but it needs planning. Paragraphs use Entity Reference Revisions, so multilingual sites must be configured carefully from the start to avoid drift.

Need help with this plugin?

We can install, configure, or customize it for you.

Installation help Order installation β€” $150

Don't want to install yourself? Our developer connects via FTP, installs, configures, tests with a real transaction. Usually takes one business day.

Contact Form Demo