Skip to main content
Drupal is a registered trademark of Dries Buytaert
EOL Warning: Drupal 11.0 has reached end of life and no longer receives security updates. EOL Warning: Drupal 10.3 has reached end of life and no longer receives security updates. EOL Warning: Drupal 10.2 has reached end of life and no longer receives security updates. EOL Warning: Drupal 10.1 has reached end of life and no longer receives security updates. EOL Warning: Drupal 10.0 has reached end of life and no longer receives security updates. EOL Warning: Drupal 9.5 has reached end of life and no longer receives security updates. EOL Warning: Drupal 9.4 has reached end of life and no longer receives security updates. EOL Warning: Drupal 9.3 has reached end of life and no longer receives security updates. Usage Milestone: jQuery UI Datepicker Module jquery_ui_datepicker crossed 1,000 active installs. Release: Media Entity: Unsplash 2.1.0 Minor update available for module media_entity_unsplash (2.1.0).

Paragraphs

245,002 sites Security covered Drupal 10–11 Paragraphs ecosystem
View on drupal.org

Paragraphs enables content creators to build flexible content layouts by allowing them to choose from a variety of pre-defined content blocks, such as text, images, slideshows, or embeddable media. Site builders can create these content blocks, called Paragraph Types, which can contain different fields and display configurations. Content editors can then add and reorder these Paragraphs within a dedicated field on a content item, offering more control over their content's structure and appearance than a simple WYSIWYG field.

Overview

Paragraphs is the new way of content creation!
It allows you — Site Builders — to make things cleaner so that you can give more editing power to your end-users.

Instead of putting all their content in one WYSIWYG body field including images and videos, end-users can now choose on-the-fly between pre-defined Paragraph Types independent from one another. Paragraph Types can be anything you want from a simple text block or image to a complex and configurable slideshow.

Paragraphs module comes with a new "paragraphs" field type that works like Entity Reference's. Simply add a new paragraphs field on any Content Type you want and choose which Paragraph Types should be available to end-users. They can then add as many Paragraph items as you allowed them to and reorder them at will.

Paragraphs module does not come with any default Paragraph Types but since they are basic Drupal Entities you can have complete control over what fields they should be composed of and what they should look like through the typical Drupal Manage Fields and Manage Display screens.

You can also add custom option fields and do conditional coding in your CSS, JS and preprocess functions so that end-users can have more control over the look and feel of each item. This is way much cleaner and stable than adding inline CSS or classes inside the body field's source.

So... what's it gonna be? Accordions, Tabs, Slideshows, Masonry galleries, Parallax backgrounds...? Think big!

Some more examples:

  • Add a block of text with an image left to it
  • Add a slideshow between blocks of text
  • Add a youtube embed between your text
  • Add quotes between your content blocks

Features

This module has some overlapping functionality with field_collection, but this module has some advantages over field_collection.

  • Different fields per paragraph bundle
  • Using different paragraph bundles in a single paragraph field
  • Displays per paragraph bundle
  • Bundles are exportable with features.
  • Entities, so: exportable field bases/instances, usable in Search API, usable in Views

Related modules

Demo sites

  • Create a new task to get your site in here

Drupal 8

Paragraphs evolved significantly since its full feature port of Drupal 7.

The module currently offers two widgets:

Classic widget

This widget offers a stable UI with limited features that will not be changed or updated. Bugfixing only.

EXPERIMENTAL widget

This widget provides many new features like duplicating paragraphs and a drag & drop mode as well as an improved decluttered user experience. It is in heavy use but major changes between versions are to be expected.

This widget functionality can be extended through Paragraphs Behavior Plugins.

Requirements

Use Diff to indicate changes between revision.

Drupal 7

See this page for the Drupal 7 information and documentation. It requires Entity >= 1.2.

Credits: Paragraphs logo by Nico Grienauer (Grienauer).

Depends on

Dependencies of the latest stable release

Required by

151 tracked projects depend on this one

Activity

Tracked releases
5
Tracked since
Mar 2025
Latest release
3 weeks ago
Releases (12 mo)
4 ▲ from 1
Maintenance
Active

Release Timeline

Releases

Version Type Core Release date
8.x-1.23 Stable 10–11 Aug 5, 2026
8.x-1.22 Stable 10–11 Aug 2, 2026
8.x-1.21 Stable 10–11 Jun 24, 2026
8.x-1.20 Stable 10–11 Jan 1, 2026
8.x-1.19 Stable 10–11 Mar 2, 2025