JCR preview definition

JCR preview definition ensures that a content app can render previews of binary data (e.g. an image) for the JCR nodes of a given data source. It implements the info.magnolia.ui.datasource.PreviewDefinition interface.

JCR preview definition is part of the Magnolia 6 UI framework. The fully qualified class name is info.magnolia.ui.contentapp.preview.JcrPreviewDefinition.

If you work with the Magnolia 5 UI framework, see Image provider definition instead.

Example definition

  $type: jcrDatasource
  workspace: contacts
    nodeName: photo
    class: info.magnolia.ui.contentapp.preview.JcrPreviewDefinition
    extension: .png

List of properties

Property Description


required, default is JcrConstants.JCR_CONTENT

Name of the JCR node where the original source image is stored. For example, if a file upload field on a form stores the image in a node named photo, set the value to photo.


optional, default is info.magnolia.ui.contentapp.preview.JcrPreviewDefinition

Preview definition class that reads the configuration properties and can supply additional parameters to the class. Set the value to a fully qualified class name.


optional, default is jpg

Extension used to deliver the image.


optional, default is portrait

Name of the image generator that generates thumbnail images.


optional, default is .imaging

Path where the imaging servlet resides.


DX Core



This widget lets you know where you are on the docs site.

You are currently perusing through the DX Core docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules
6.3 beta

Magnolia 6.3 beta

Magnolia 6.3 is in beta. We are updating docs based on development and feedback. Consider the 6.3 docs currently in a state of progress and not final.

We are working on some 6.3-beta known issues during this phase.