Enabling Component Based Design in Drupal

Component-based design systems are quite common in product design because they enable consistency, coherence and productivity in large design and engineering teams.

Component based design systems are somehow overlooked in websites as they’re one-off builds and don’t have ongoing dedicated teams. They also tend to be quite distinctive and built by outside firms – both of which preclude this sort of rigor. However, with websites getting larger, more sophisticated and critical, this thinking is beginning to change. At the same time, the toolkits are evolving to better support this trend.


In this article, we will discuss how we enabled this “Component-Based Design” approach in Drupal 9. 

The Client Need

We redesigned and built a new website for our client Reynolds Brands: www.reynoldsbrands.com. As part of this launch, they required a robust set of components using which they could build their own pages by quickly assembling a few from the library. 

The specific requirements for each of these components was the following:

  • They should be able to “drag-drop” any component onto a page and assemble it quickly by themselves
  • Each component should present a specific set of choices for entering data such as Title, Description, Images, Background Colors etc.

Below are a few examples of the components that were requested by Reynolds:

Related Content

Single Video Section

General Required Product

Three Column Related Product


General CTA Promotion

Full Width Paragraph

Text With Background Image

Two Column Video

Text with Video

To elaborate, the content editing experience for a component like the one shown below, would be as follows:

Step 1: Create a new page and select the component (like shown below)

Step 2: Enter the relevant data into the component. In this case, that would be the title, description, button text, button URL and the background color of the section. 

Step 3: Save the page and publish it! The overall point was to be super user-friendly and avoid any developer or designer involvement. 

In the next section, we will describe how we achieved this in Drupal 9. 

Architectural Approach in Drupal 9

Step 1: Leverage “Paragraphs” to model the content

Paragraphs is a new way of content creation. It allows the site builders to make things cleaner and can give more editing power to the end-users.

Instead of adding all the content in one WYSIWYG body field including images and videos,  we can create multiple Paragraphs Types with different structures. This allows the end user to choose between pre-defined Paragraphs Types.. Paragraph Types can be anything you want from a simple text block or image to a complex and configurable slideshow.

Paragraph functionality can be added to Drupal by simply installing the paragraph module.

Step 2: Combine Styling with the content

In paragraphs content can be combined with styling using drupal twig template. We can customize the HTML structure in the template based on the requirement.

Paragraphs uses twig template naming suggestions like core Drupal modules. The default paragraphs template is provided in paragraphs/templates/paragraph.html.twig.

The following suggestions are available, the most specific (used first) to least specific:


(e.g. paragraph--image--default.html.twig)


(e.g. paragraph--image.html.twig)


(e.g. paragraph--default.html.twig)


Step 3: Add this component to a Content Type

Paragraphs module comes with a new "paragraphs' field type that works like Entity Reference's. Using this feature we can 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. All these features of paragraphs are what we need as reusable components.

Created Paragraph can be enabled in the content type using this paragraph entity reference as follows.

In the content type page, we can add the desired paragraph type using the reference field.

After adding and configuring the paragraphs in the page, we can rearrange the paragraphs by using the drag and drop functionality in the entity reference field.

A Detailed Example

A General full width paragraph type is created using Structure → Paragraph Type  → Add Paragraph Type.

Content fields for the paragraph type can be added and configured under the Manage fields tab.

We have added a Title and Content text field to manage the headline and description, a link field to add a button, and a list field to select a background color for the section.

A twig template paragraph--full-width-paragraph--default.html.twig is created based on the twig suggestion. HTML code and necessary twig code is added to fetch the field values from the page.

The paragraph type is added to the content type “General Content” and configured as follows.

The end result will be as follows.

In Conclusion, once you understand how to harness the power of paragraphs and combine it with the “content field” and style them within the Twig template, you can create a vast array of components to use throughout your Drupal websites. 

 If you liked this insight and want more updates, we’d love for you to join us on Linkedin, Facebook and Twitter

No items found.

Related Insights

8 Reasons: Drupal Proves to be a Top Pick for Government Sites

Find out why most government websites prefer and should be built on Drupal

Ashwin Thapliyal


Creating a robust TailwindCSS Pipeline for Custom Drupal Theme

Find out how to set up a TailwindCSS pipeline for a custom Drupal theme

Anirudh Mahant


Subscribe to our newsletter