---
title: 'Custom Preview Setter'
url: 'https://doc.brix.ch/celum_extensions/custom_preview_setter'
markdown: 'https://doc.brix.ch/celum_extensions/custom_preview_setter.md'
lang: en
date: '2026-10-26'
description: 'Technical documentation for the CELUM Extension "Custom Preview Setter" – Software developed by brix'
taxonomy:
  category:
    - docs
---

[](#) 

  [ Welcome ](https://doc.brix.ch/)     [ CELUM Extensions ](https://doc.brix.ch/celum_extensions)      Custom Preview Setter    

# Custom Preview Setter

![Advanced-UI](https://img.shields.io/static/v1?label=UI&message=Advanced&color=lightgrey)![NOVA-UI](https://img.shields.io/static/v1?label=UI&message=NOVA&color=blue)

The *Custom Preview Setter* plugin allows you to upload a custom preview image that replaces the one generated by the system.

The label for the key of the menu item is *customPreviewSetter.menuTitle* and can be customized via the *{home}/appserver/lang/customMessages\_xx.properties* files.

#### Table of Contents

- [Properties](#properties)
- [Screenshots](#screenshots)
- [Compatibility Matrix](#compatibility-matrix)
- [Release Notes](#release-notes)

## Properties

To be configured in *{home}/appserver/conf/custom.properties*.

##### customPreviewSetter.license

> type: String, **required: yes**, default: -

The license key for the plugin (product: customPreviewSetter), provided by *brix*.

##### customPreviewSetter.allowedUserGroups

> type: List of Long, required: no, default: - (Superadmins)

The plugin's menu entry is only visible for those user groups and Superadmins.

## Screenshots

before - during - after:

![screenshot](https://doc.brix.ch/user/pages/01.celum_extensions/45.custom_preview_setter/screenshot-marked.jpg)

## Compatibility Matrix

| Custom Previews | CELUM (min. version) |
|---|---|
| 1.0 | 5.13.4 (tested up to 6.6) |
| 1.1 | 5.13.4 (tested up to 6.7) |
| 1.2 | 5.13.4 (tested up to 6.7) |
| 1.3 | 6.8 (tested up to 6.14) |
| 1.4 | 6.20 |

| Nova Plugin | CELUM (min. version) | Backend Plugin (min. version) |
|---|---|---|
| 1.0.0 | 6.10.0 | 1.2.0 |
| 1.0.1 | 6.11.0 | 1.2.0 |

## Release Notes

#### 1.0

> Released 2020-09-18

Initial Version

#### 1.1

> Released 2020-10-15

Enabled setting (the same) preview on multiple assets at once

#### 1.2

> Released 2021-11-23

Nova compatibility

#### 1.3

> Released 2023-05-10

Compatibility update for 6.8+

#### 1.4

> Released 2025-02-13

Compatibility update for 6.20

 [ ](https://doc.brix.ch/celum_extensions/upload_request_3/old_upload_request) [](https://doc.brix.ch/celum_extensions/version_viewer)

---

## Navigation

- Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md)
- Previous: [Upload Request 3](https://doc.brix.ch/celum_extensions/upload_request_3.md)
- Next: [Version Viewer](https://doc.brix.ch/celum_extensions/version_viewer.md)