Image and Asset Upload Configuration
Bloomreach Content uses the HTML5 file upload plugin to handle image and asset uploads in the CMS. You can control upload behavior and restrictions by configuring specific properties.
Images
Dialog Configuration
Configure image upload dialogs at the following JCR path:
/hippo:configuration/hippo:workflows/gallery/image-gallery/frontend:renderer
| Name | Type | Description | Default dialog value | Default template value |
|---|---|---|---|---|
fileupload.maxItems | Long | Sets the maximum number of files that can be uploaded in a single dialog or template. Note: If fileupload.autoUpload is enabled, files are uploaded immediately upon selection, regardless of this limit. | 25 | 1 |
svg.scripts.enabled | Boolean | Available in CMS 12.0.4 and later. By default, uploading SVG images with embedded JavaScript is disabled. To allow SVG uploads with JavaScript, add this property and set it to 'true'. | ||
fileupload.allowedExtensions | String (multiple) | Specifies allowed file extensions (e.g., *.jpg, *.gif). Leave blank to allow any extension. Note: Deprecated as of v2.22.11. Use UploadValidationService instead. See Image and Asset Upload Validation. | *.jpg, *.jpeg, *.gif, *.png | *.jpg, *.jpeg, *.gif, *.png |
file.extensions | String (multiple) | Same as fileupload.allowedExtensions. Retained for backward compatibility. |
Template Configuration
Configure image upload templates at:
/hippo:namespaces/hippogallery/image/editor:templates/_default_/upload
Image Display Configuration
Configure how uploaded images are displayed at:
/hippo:namespaces/hippogallery/image/editor:templates/_default_/display
Maximum Height and Width for Displayed Images
When an image exceeds the default maximum resolution (800 x 800), the CMS displays "Image too large to be shown." To change the maximum allowed resolution, set the display.max.height and display.max.width properties on the display node.
Hiding Mime Type, File Size, and Download Link
Starting with version 14.1, the CMS displays mime type, file size, and a download link for image variants, including those too large to display. To hide this metadata and show only the dimensions, set the boolean property display.dimensions.only=true on the display node.
Assets
Dialog Configuration
Configure asset upload dialogs at:
/hippo:configuration/hippo:workflows/gallery/asset-gallery/frontend:renderer
| Name | Type | Description | Default dialog value | Default template value |
|---|---|---|---|---|
fileupload.maxItems | Long | Sets the maximum number of files that can be uploaded in a single dialog or template. Note: If fileupload.autoUpload is enabled, files are uploaded immediately upon selection, regardless of this limit. | 25 | 1 |
fileupload.allowedExtensions | String (multiple) | Specifies allowed file extensions (e.g., *.jpg, *.gif). Leave blank to allow any extension. Note: Deprecated as of v2.22.11. Use UploadValidationService instead. See Image and Asset Upload Validation. | ||
file.extensions | String (multiple) | Same as fileupload.allowedExtensions. Retained for backward compatibility. |
Template Configuration
Configure asset upload templates at:
/hippo:namespaces/hippo/resource/editor:templates/_default_/upload