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

[](#) 

  [ Welcome ](https://doc.brix.ch/)     [ CELUM Extensions ](https://doc.brix.ch/celum_extensions)      Asset Validation    

# Asset Validation

![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 "Asset Validation" plugin allows to validate assets and marks them if they do not pass the validation.

#### Table of Contents

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

## Properties

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

##### assetValidation.license

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

License key (delivered by brix Solutions AG)

##### assetValidation.validators

> type: List of String (comma-separated), **required: yes**, default: -

This property takes a list of all validators that are enabled.

### Validators

Every validator has its own properties. For every validator, the following properties are the same. Replace `{validatorName}` with the name of the validator specified in the section for the validator further down.

##### assetValidation.{validatorName}.nodeIdValid

> type: long, required: no, default: -

If this property is set, the valid assets are collected in the configured node. This can help to find the valid assets and get an overview. Initially, all the assets can be validated and added to the node by running the "Revalidate Assets"-Task in "General"-Tab in System Tasks.

##### assetValidation.{validatorName}.nodeIdInvalid

> type: long, required: no, default: -

If this property is set, the invalid assets are collected in the configured node. This can help to find the valid assets and get an overview. Initially, all the assets can be validated and added to the node by running the "Revalidate Assets"-Task in "General"-Tab in System Tasks.

##### assetValidation.{validatorName}.imagePath

> type: String, required: no, default: -

This property takes a 16x16 px image which is shown on invalid assets. NOTE: to show the bullet, the validatorName needs to be added to the list of bullets in the property "guiPlugin.bullets.asset=". This property is global and may be also used by other plugins. If not, the celum bullets need to be added to the list, e.g. `guiPlugin.bullets.asset=noAssetType,invalidInformationFields,unlinked,unreleased,availability,locked,duplicate,conversionStatus,fileTypeWhitelistValdiator`

##### assetValidation.{validatorName}.bulletId

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

This property sets the ID of the bullet shown on invalid assets. The ID must also be added to the `guiPlugin.bullets.asset` property.

##### assetValidation.{validatorName}.bulletTitle

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

This property sets the mouseover-title on the bullet. For multilanguage-support, add your messages to `appserver/lang/customMessages_xy.properties` and use the key here.

##### assetValidation.{validatorName}.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is invalid and to false if the validation is valid.

##### assetValidation.{validatorName}.forAssetTypes

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

If this property is set, the validator is only applied to assets of the configured asset type IDs.

##### assetValidation.{validatorName}.forFileTypes

> type: List of String (comma-separated), required: no, default: -

If this property is set, the validator is only applied to assets with the configured file extensions.

#### File Type Whitelist

This validator takes a list of allowed file extensions.

- validatorName: fileTypeWhiteList
- bulletName: fileTypeWhiteListValidator

##### assetValidation.fileTypeWhiteList.whitelist

> type: List of String (comma-separated), **required: yes**, default: -

All file extensions set in this property are allowed. Assets with one of these extensions are valid.

##### assetValidation.fileTypeWhiteList.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Image Resolution Product Validator

This validator takes a minimum width multiplied by height in pixels an image must have.

- validatorName: imageResolutionProductValidator
- bulletName: imageResolutionProductValidator

##### assetValidation.imageResolutionProductValidator.minResolutionProduct

> type: long, **required: yes**, default: 0

This property takes the minimum required product of the image width and height in pixels.

##### assetValidation.imageResolutionProductValidator.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Video Resolution Validator

This validator takes a minWidth and / or minHeight in pixels a video must have.

- validatorName: videoResolution
- bulletName: videoResolutionValidator

##### assetValidation.videoResolution.mode

> type: String, required: no, default: AND

This property can be set to 'OR' or 'AND'. 'OR': The video needs to have either minWidth or minHeight to be valid. 'AND': A video needs to have minWidth and minHeight to be valid.

##### assetValidation.videoResolution.minWidth

> type: long, required: no, default: 0

This property takes the minWidth a video must have.

##### assetValidation.videoResolution.minHeight

> type: long, required: no, default: 0

This property takes the minHeight a video must have.

##### assetValidation.videoResolution.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Digital Image Colorspace Validator

This validator takes a list of allowed colorspaces for digital images.

- validatorName: digitalImageColorspace
- bulletName: digitalImageColorspaceValidator

##### assetValidation.digitalImageColorspace.colorspaces

> type: List of String (comma-separated), **required: yes**, default: -

All colorspaces set in this property are allowed. Digital images with one of these colorspaces are valid.

##### assetValidation.digitalImageColorspace.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Print Image Colorspace Validator

This validator takes a list of allowed colorspaces for print images.

- validatorName: printImageColorspace
- bulletName: printImageColorspaceValidator

##### assetValidation.printImageColorspace.colorspaces

> type: List of String (comma-separated), **required: yes**, default: -

All colorspaces set in this property are allowed. Print images with one of these colorspaces are valid.

##### assetValidation.printImageColorspace.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Image Color Depth Validator

This validator takes a list of allowed color depths for images.

- validatorName: imageColorDepth
- bulletName: imageColorDepthValidator

##### assetValidation.imageColorDepth.colorDepthList

> type: List of String (comma-separated), **required: yes**, default: -

All color depths set in this property are allowed. Images with one of these color depths are valid.

##### assetValidation.imageColorDepth.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Video Color Depth Validator

This validator takes a list of allowed color depths for videos.

- validatorName: videoColorDepth
- bulletName: videoColorDepthValidator

##### assetValidation.videoColorDepth.colorDepthList

> type: List of String (comma-separated), **required: yes**, default: -

All color depths set in this property are allowed. Videos with one of these color depths are valid.

##### assetValidation.videoColorDepth.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Video Codec Validator

This validator takes a list of allowed video codecs.

- validatorName: videoCodec
- bulletName: videoCodecValidator

##### assetValidation.videoCodec.videoCodecList

> type: List of String (comma-separated), **required: yes**, default: -

All video codecs set in this property are allowed. Videos with one of these codecs are valid.

##### assetValidation.videoCodec.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### File Type Blacklist

This validator takes a list of forbidden file extensions.

- validatorName: fileTypeBlacklist
- bulletName: fileTypeBlacklistValidator

##### assetValidation.fileTypeBlacklist.blacklist

> type: List of String (comma-separated), **required: yes**, default: -

All file extensions set in this property are prohibited. Assets with one of these extensions are invalid.

##### assetValidation.fileTypeBlacklist.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Combined Validator

This validator combines multiple validators. An asset is valid only if all configured validators are valid.

- validatorName: combinedValidator
- bulletName: combinedValidator

##### assetValidation.combinedValidator.validators

> type: List of String (comma-separated), **required: yes**, default: -

This property takes the bullet names of the validators to combine.

##### assetValidation.combinedValidator.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Minimum Size Validator

This validator takes a minimum size in pixels. The larger image dimension must reach this value.

- validatorName: minSizeValidator
- bulletName: minSizeValidator

##### assetValidation.minSizeValidator.size

> type: long, **required: yes**, default: 0

This property takes the minimum required size of the larger image dimension in pixels.

##### assetValidation.minSizeValidator.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Duplicate Validator

This validator marks duplicate assets.

- validatorName: duplicateValidator
- bulletName: duplicateValidator

##### assetValidation.duplicateValidator.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Densitiy

This validator takes a minimum density for assets to be valid.

- validatorName: density
- bulletName: densityValidator

##### assetValidation.density.noDensityValid

> type: Boolean, **required: yes**, default: false

If this property is set to true, the asset has a valid density if there is no density given on the asset.

##### assetValidation.density.minDensity

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

This property takes the minimum required density for an asset to be valid.

##### assetValidation.density.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Image Resolution Validator

This valdiator takes a minWidth and / or minHeight in pixels an image must have.

- validatorName: imageResolution
- bulletName: imageResolutionValidator

##### assetValidation.imageResolution.mode

> type: String, required: no, default: OR

This property can be set to 'OR' or 'AND'. 'OR': The image needs to have either minWidht or minHeight to be valid. 'AND': An image needs to have minWidth and minHeight to be valid.

##### assetValidation.imageResolution.minWidth

> type: long, required: no, default: 0

This property takes the minWidth an image must have. Note: If the imageResolution.mode is set to OR a valid image may not have the set minWidth since the minHeigt may be reached.

##### assetValidation.imageResolution.minHeight

> type: long, required: no, default: 0

This property takes the minHeight an image must have. Note: If the imageResolution.mode is set to OR a valid image may not have the set minHeight since the minWidth may be reached.

##### assetValidation.imageResolution.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

#### Asset Name Validator

This Validator takes a list of forbidden strings that are not allowed in the asset name.

- validatorName: assetNameValidator
- bulletName: assetNameValidator

##### assetValidation.assetNameValidator.notAllowed

> type: List of String (comma-separated), **required: yes**, default: -

This property takes a list of strings that are not allowed in the asset name.

##### assetValidation.assetNameValidator.checkboxId

> type: InformationFieldId, required: no, default: -

Sets the checkbox to true if the validation is true.

## Example

Using two validators, one for density and one for resolution:

```
guiPlugin.bullets.asset=noAssetType,invalidInformationFields,validMetadata,unlinked,unreleased,availability,locked,duplicate,conversionStatus,densityValidator,imageResolutionValidator

assetValidation.license=***
assetValidation.validators=densityValidator,imageResolutionValidator

assetValidation.density.bulletId=densityValidator
assetValidation.density.bulletTitle=assetValidation.invalidDensity
assetValidation.density.noDensityValid=false
assetValidation.density.nodeIdInvalid=26530
assetValidation.density.minDensity=300
assetValidation.density.forFileTypes=png,jpg

assetValidation.imageResolution.bulletId=imageResolutionValidator
assetValidation.imageResolution.bulletTitle=assetValidation.invalidResolution
assetValidation.imageResolution.nodeIdInvalid=26531
assetValidation.imageResolution.minWidth=1000
assetValidation.imageResolution.minHeight=1000
assetValidation.imageResolution.mode=AND
assetValidation.imageResolution.forFileTypes=png,jpg
```

## Compatibility Matrix

| Asset Validator | CELUM (min. version) |
|---|---|
| 1.0-1.3 | 5.13.4 |
| 1.4.0 | 6.20 |
| 1.4.2 | 7.1 |

## Release Notes

#### 1.0

> Released 2018-06-15

Initial Version

#### 1.1

> Released 2018-06-20

Added Blacklist Filetype Validator

#### 1.2

> Released 2021-01-20

- Additional asset validators: Bit depth validator, video Codec validator, Color space validator
- Possibility to apply validators only for specific filetypes

#### 1.3

> Released 2022-05-04

- Various improvements to the validators

#### 1.4

> Released 2025-02-13

- Compatibility with CELUM 6.20

#### 1.4.2

> Released 2026-07-21

- Compatibility with CELUM 7.1

 [ ](https://doc.brix.ch/celum_extensions/share_listing) [](https://doc.brix.ch/celum_extensions/auto_delete_task)

---

## Navigation

- Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md)
- Previous: [Share Listing](https://doc.brix.ch/celum_extensions/share_listing.md)
- Next: [Auto Delete Task](https://doc.brix.ch/celum_extensions/auto_delete_task.md)
