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
- Paragraphs pack
- Classy paragraphs
- Edgy
- Entity background
- Paragraphs Defaults
- Apachesolr Paragraphs
- Paragraphs ID
- Entity behaviors
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
- Entity Reference Revisions
- file Drupal core
Required by
151 tracked projects depend on this one
- Paragraphs Features 23,377 sites
- Layout Paragraphs 17,488 sites
- Paragraphs Edit 13,368 sites
- Paragraphs Browser 9,876 sites
- Paragraph View Mode 5,594 sites
- Quiz 2,898 sites
- Paragraphs Sets 2,883 sites
- Paragraph blocks 2,856 sites
- Paragraphs admin 2,853 sites
- Paragraphs table 2,500 sites
- Paragraphs Report 2,059 sites
- Paragraphs jQuery UI Accordion 1,558 sites
- Paragraphs entity embed 1,535 sites
- Paragraphs View Modes 1,445 sites
- Feeds Paragraphs 1,115 sites
- Extra Paragraph Types (EPT): Core 1,079 sites
- Default Paragraphs 851 sites
- Paragraphs Bundles 832 sites
- Paragraphs Clipboard 737 sites
- Paragraphs Inline Entity Form 578 sites
- LocalGov Paragraphs 576 sites
- Paragraphs Summary Token 566 sites
- Geysir 527 sites
- LocalGov Page Components 515 sites
- Paragraphs Modal Edit 486 sites
- Paragraphs summary formatter 444 sites
- LocalGov Subsites 409 sites
- Paragraphs Role Visibility 393 sites
- Extra Paragraph Types (EPT): Image Gallery 365 sites
- Extra Block Types (EBT): Basic Button 350 sites
- Extra Block Types (EBT): Tabs 346 sites
- Dismissible Message Bar 318 sites
- Extra Paragraph Types (EPT): Accordion 304 sites
- Paragraphs Trimmed 294 sites
- Extra Paragraph Types (EPT): Text 286 sites
- Paragraphs Type Help 282 sites
- Extra Block Types (EBT): Slideshow 281 sites
- USWDS Paragraph Components 277 sites
- Extra Paragraph Types (EPT): Basic Button 258 sites
- W3CSS Paragraphs Renamed and Enhanced as Paragraphs Bundles 255 sites
- Extra Block Types (EBT): Slick Slider 230 sites
- Extra Paragraph Types (EPT): Image 222 sites
- Civictheme 218 sites
- Extra Block Types (EBT): Accordion / FAQ 214 sites
- Droopler 212 sites
- Extra Paragraph Types (EPT): Tiles 197 sites
- Extra Paragraph Types (EPT): Slideshow 196 sites
- Layout Paragraphs Toggle Publish 187 sites
- Extra Paragraph Types (EPT): Carousel 186 sites
- Extra Paragraph Types (EPT): Tabs 167 sites
- Extra Block Types (EBT): Carousel 160 sites
- Extra Paragraph Types (EPT): Hero 160 sites
- Extra Paragraph Types (EPT): Video 156 sites
- Extra Paragraph Types (EPT): Video and Image Gallery 155 sites
- Extra Block Types (EBT): Call to Action 145 sites
- Extra Paragraph Types (EPT): Columns / Container 143 sites
- Paragraphs Table of Contents 139 sites
- Extra Paragraph Types (EPT): Webform 138 sites
- Extra Paragraph Types (EPT): Call to Action 137 sites
- Extra Paragraph Types (EPT): Block 136 sites
- Extra Block Types (EBT): Counter 131 sites
- Extra Paragraph Types (EPT): Views 129 sites
- Extra Paragraph Types (EPT): Counter 128 sites
- Extra Paragraph Types (EPT): Timeline 127 sites
- Extra Paragraph Types (EPT): Bootstrap Button 125 sites
- Extra Paragraph Types (EPT): Slick Slider 123 sites
- Extra Block Types (EBT): Webform Popup 121 sites
- Extra Block Types (EBT): Hero 120 sites
- Anu LMS 112 sites
- Extra Block Types (EBT): Timeline 112 sites
- Seeds Page 111 sites
- Extra Paragraph Types (EPT): Countdown 105 sites
- Paragraphs tab widget 104 sites
- Extra Paragraph Types (EPT): Micromodal 99 sites
- Extra Paragraph Types (EPT): Quote 99 sites
- Dropsolid Rocketship Core 98 sites
- Extra Block Types (EBT): Webform 91 sites
- Node Session for Open Y 89 sites
- Extra Block Types (EBT): Tiles 88 sites
- Extra Block Types (EBT): Countdown 87 sites
- Extra Block Types (EBT): Video 86 sites
- Extra Block Types (EBT): Stats 85 sites
- Extra Block Types (EBT): Video and Image Gallery 83 sites
- Extra Paragraph Types (EPT): Stats 83 sites
- Taxonomy Overview 77 sites
- Big Pipe Paragraphs 77 sites
- Extra Paragraph Types (EPT): Webform Popup 74 sites
- Paragraphs Blökkli 72 sites
- LocalGov Page 67 sites
- Paragraphs Browser Deploy 59 sites
- Dropsolid Rocketship Paragraphs 54 sites
- Paragraphs List Filter 53 sites
- Paragraph SDC 52 sites
- Quiz Maker 48 sites
- Commerce ML Starter 42 sites
- Paragraph Group 40 sites
- LocalGov Publications Importer 37 sites
- Paragraphs tabs bootstrap 33 sites
- Paragraph Handler 29 sites
- Layout Paragraphs Theme Extension 22 sites
- Extra Paragraph Types (EPT): Sticky Menu 18 sites
- Paragraphs Media Icons - Pro 18 sites
- Paragraphs Bundles Import 18 sites
- UI Suite USWDS Paragraphs 17 sites
- Paragraph Lineage 14 sites
- DROWL Paragraphs 14 sites
- Paragraphs accordion 13 sites
- Paragraphs Contextual Validation 12 sites
- Paragraphs Usage Manager 10 sites
- Draggable Mapper 10 sites
- Paragraphs Responsive Background Image Formatter 9 sites
- Importer 8 sites
- Social Course 8 sites
- Paragraphs Components AI for Canvas 6 sites
- Improve Paragraphs library items 6 sites
- Paragraphs Modal Add 6 sites
- Field Per Commerce Store 5 sites
- Indiana University Paragraphs 5 sites
- Invoice Management 5 sites
- Paragraphs iFrame Preview 5 sites
- Bluecheese 4 sites
- Mercury Editor Page Templates 4 sites
- Paragraphs Title Manager 3 sites
- Style Options Conditions 3 sites
- GEO Starter JSON-LD 3 sites
- Paragraphs EE Auto Open 3 sites
- Commerce Product CSV Import/Export 3 sites
- Paragraphs Component Library 3 sites
- Paragraphs Sum Formatter 3 sites
- DROWL Paragraphs for Bootstrap 2 sites
- Universal Entity API 2 sites
- Webform OpenFisca 1 sites
- Contribution Records 1 sites
- Extra Paragraph Types (EPT): Images 1 sites
- Paragraphs field validator 1 sites
- Field Style 1 sites
- Bulk Paragraphs 1 sites
- Paragraphs extended modal 1 sites
- Paragraphs gantt 1 sites
- WAT WAT 1 sites
- Paragraphs Type Availability
- Hubspot Integration
- Paragraphs Health
- Bulk Paragraph Delete
- Intercept Profile
- Paragraph Session Table for Open Y
- Seeds Headless Using NextJS
- Starman
- Paragraphs Condition
- Paragraphs Entity Embed Assets
- Paragraphs grid
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 8.x-1.23 | Stable | 10–11 | Fixes a regression with summaries on Drupal 10 | Aug 5, 2026 | |
| 8.x-1.22 | Stable | 10–11 | Bugfixes, performance improvements and preparations for Drupal 12 | Aug 2, 2026 | |
| 8.x-1.21 | Stable | 10–11 | Security release | Jun 24, 2026 | |
| 8.x-1.20 | Stable | 10–11 | Bugfixes, performance improvement for Drupal 11.3 | Jan 1, 2026 | |
| 8.x-1.19 | Stable | 10–11 | Support for PHP 8.4 support, attribute plugin discovery, new entity duplicate hook (11.2+) and various bugfixes | Mar 2, 2025 |