Paragraphs

Rather than one large text box for an entire page, ITS Drupal sites use Paragraphs—discrete modules such as text blocks, accordions, image grids, and call-to-action banners—that you select, configure, and stack to build layouts. This keeps pages responsive and aligned with university design without writing HTML.

How Paragraphs function within a page

A Page node is the structural container; Paragraphs are the building blocks inside it. You can add as many Paragraphs as your content needs. Each module is independent, so you might follow a text block with an FAQ accordion and then a video embed on the same page.

Managing Paragraph modules

When you edit a Page, the Paragraphs area appears below the main title.

Adding components

At the bottom of the stack, click a button such as Add Text or Add Accordion to append a new blank instance of that type.

Reordering components

Hover over the drag handle (↕) on the left of a block, click and hold, drag to a new position, and release.

Removing components

Use Remove or the three-dot menu on the block header. Only that block’s content is deleted; other Paragraphs on the page are unaffected.

Best practices for building with Paragraphs

Maintain heading hierarchies

The page title is heading level 1. Inside Paragraphs, start sections at H2 and use H3 for subsections. Skipping levels (for example, H2 to H4) breaks accessibility compliance. See Accessibility.

Use preview and collapse

On long pages, use Collapse all at the top of the Paragraphs field to shrink blocks to bars, which makes reordering large sections easier.

Draft content chronologically

Because Paragraphs stack vertically, outline your page before entering text to reduce dragging during publishing.

Control visibility when needed

Some Paragraph types can be unpublished individually for seasonal or in-progress content. See Publishing & Unpublishing.