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

[](#) 

  [ Welcome ](https://doc.brix.ch/)     [ CELUM Extensions ](https://doc.brix.ch/celum_extensions)      Version Cleanup    

# Version Cleanup

![No UI](https://img.shields.io/static/v1?label=UI&message=none&color=inactive)

With the Version Cleanup pluging a system task deletes outdated versions. The following configurations are possible:

- Filter expression (see Search Util 2) to define the scope. If no filter is defined, all assets will be processed.
- Rules (can be combined): 
    - Number of Version: Only the most recent n versions are retained; all older versions are deleted.
    - Days: Any version with a version date older than x days is deleted.
- Additionally, you can define that the base version is never deleted.

The current version is never deleted.

#### Table of Contents

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

## Properties

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

##### versionCleanup.license

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

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

##### versionCleanup.cronExpression

> type: quartz-expression, required: no, default: -

A Quartz cron expression for automating the task.

##### versionCleanup.filter

> type: String, required: no, default: "created > \\"1970-01-01\\""

Filter expression (see Search Util 2) to define which assets are processed in the Task. If no filter is defined, all assets will be processed.

##### versionCleanup.filterBaseVersion

> type: boolean, required: no, default: true

If true, skips the asset if its current version is 0, assuming no other versions exist. Primarily intended to improve performance.

##### versionCleanup.keepBaseVersion

> type: boolean, required: no, default: true

If true, the base version is never deleted.

### Filter Properties

Define the active filter types as follows and specify their {order} from 0 to n. This defines the order in which the filters are applied.

**Example**

In this example, the active version and the version before it are kept, regardless of the date. The other versions are deleted if they are older than 180 days.

```
versionCleanup.activeFilters.0.type=NUMBER
versionCleanup.activeFilters.0.value=1
versionCleanup.activeFilters.1.type=DAY
versionCleanup.activeFilters.1.value=180
```

##### activeFilters.{order}.type

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

Define the filter type. Currently, the supported types are **DAY** and **NUMBER**.

- DAY: Any version with a version date older than x days is deleted.
- NUMBER: Only the most recent n versions are retained.

##### activeFilters.{order}.value

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

Define the value for the filter type.

## Compatibility Matrix

| Version Cleanup | CELUM (min. version) |
|---|---|
| 1.0 | 6.16 (tested with 6.16) |
| 1.1 | 6.20 |
| 1.2 | 6.20 |

## Release Notes

#### 1.0

> Release: 2025-06-13

Initial Version

#### 1.1

> Release: 2025-08-04

6.20 version

#### 1.2

> Release: 2025-10-14

- property: keepBaseVersion
- joinable filter

 [ ](https://doc.brix.ch/celum_extensions/table_editor) [](https://doc.brix.ch/celum_extensions/multinode)

---

## Navigation

- Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md)
- Previous: [Table Editor](https://doc.brix.ch/celum_extensions/table_editor.md)
- Next: [Multinode Check](https://doc.brix.ch/celum_extensions/multinode.md)