Skip to main content
More in Learn

Paragraph Collection Component

Paragraph collection components are used for repeating paragraphs with dedicated titles, rich text, and any number of images or videos.

Paragraph Collection Usage

The paragraph collection is a very versatile component. It has all the same formatting options as the rich text component, with the following additional features:

  • Repeatability. When you’re creating new content, you can keep adding paragraph boxes as needed to support a long-format document like an article or blog post. Once paragraphs have been added, they can be reordered or deleted.
  • Initial titles (optional). You can easily offset your paragraph headers with titles, if you have any. You can also leave them blank if you don’t.
  • Media (optional). You can attach images and videos to the end of each paragraph. The media is uploaded to our content delivery network (CDN).

When adding this component to a shape or piece, specify a name (required) and description (optional) indicative of the sort of content you wish for it to contain. This description will be visible to those who build content based off of this shape.

This component is translatable, meaning you can store different values for each language set up within your tenant. When editing an item, use the Language drop-down menu at the top of the screen to switch between translations. Refer to our Configuring Languages page for more information.

Paragraph collection on shape

When adding content to this component,  you have access to the following features:

  • Undo/Redo buttons (you can also use CTRL+Z / Shift+CTRL+Z on your keyboard)
  • Headings (H1 through H4)
  • Bold, italic and underline text
  • Code block or literal text
  • Hyperlinks
  • Strikethrough, subscript, and superscript formatting
  • Bulleted and numbered lists
  • Horizontal ruling lines
  • Tables

Use the action button (...) in the top-right corner of any paragraph to access the following options:

  • Reorder paragraphs
  • Add paragraph above
  • Add paragraph below
  • Copy JSON
  • Clear Editor
  • Remove paragraph

You can also use the plus sign button (+) on the bottom left of the last paragraph in the collection to add paragraphs. You may enter paragraph titles or leave them blank as desired.

There are multiple ways to add videos and images to a paragraph:

  • Drag and drop them from your machine onto the paragraph.
  • Click the Click here or drop to add images or videos prompt to browse your file system.
  • (images only) Magic Paste images from elsewhere in your tenant.

Once added, you can click and drag on image/video thumbnails to reorder them as desired. When you hover over an image or video thumbnail, you’ll see several options. For images, the icon in the bottom-left corner allows you to add the image to the Magic Paste lightbox. The pencil icon in the top-right corner lets you access metadata and download options. The red X in the top right allows you to remove the image/video from the paragraph.

Edit paragraph collection component

Catalogue API Access

Once created, paragraph collection components and their content are accessible via the Catalogue API. Refer to our sample query for retrieving paragraph collection component content, and to the API docs at for more information.

People showing thumbs up

Need further assistance?

Ask the Crystallize team or other enthusiasts in our slack community.

Join our slack community