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, you can specify the following:

  • Name (required) - A name for the component.
  • Identifier - String that will be generated based on the component name when shape/piece is created or updated. You’ll use the identifier to reference the component programmatically.
  • Description - An optional description of what the component should contain. This will be visible to anyone who adds content to the component later.
  • Unified Structure Across Localizations - If Yes or System Default, then the number of paragraphs will be the same for all languages. If No, then the number of paragraphs may vary from one language to the next. 
  • Localized Content - For titles, bodies, images, and videos, you can individually configure whether to permit different content for each language set up within your tenant. Anything toggled off (set to No) means that the same content will be shared across all languages.
Paragraph collection component on shape

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

  • Undo/Redo buttons (you can also use [CTRL or ⌘] + Z and Shift + [CTRL or ⌘] + Z on your keyboard)
  • Headings (H1 through H4)
  • Bold, italic and text
  • Code block or literal text
  • Hyperlinks
  • , , and 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.

Paragraph collection component usage

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 https://api.crystallize.com/your-tenant-identifier/catalogue for more information.

People showing thumbs up

Need further help?

Join and ask our
slack community.

Join our slack community