---
title: 'Batch Search And Apply Metadata'
url: 'https://doc.brix.ch/celum_extensions/batch_search_and_apply_metadata'
markdown: 'https://doc.brix.ch/celum_extensions/batch_search_and_apply_metadata.md'
lang: en
date: '2026-10-26'
description: 'Technical documentation for the CELUM Extension "Batch Search And Apply Metadata" – Software developed by brix'
taxonomy:
  category:
    - docs
---

[](#) 

  [ Welcome ](https://doc.brix.ch/)     [ CELUM Extensions ](https://doc.brix.ch/celum_extensions)      Batch Search And Apply Metadata    

# Batch Search And Apply Metadata

![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)

With the extension, you can import a predefined csv- or excel-file (containing search values and values to be written), select a search rule and import the metadata from the provided file to the corresponding assets based on an apply rule.

#### Table of Contents

- [Batch Search And Apply Metadata Core](#batch-search-and-apply-me)
- [Batch Search And Apply Metadata Providers](#batch-search-and-apply-me-1)
- [Example](#example)
- [Screenshots](#screenshots)
- [Compatibility Matrix](#compatibility-matrix)
- [Release Notes](#release-notes)

## Batch Search And Apply Metadata Core

### Properties

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

##### batchSearchAndApplyMetadata.license

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

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

##### batchSearchAndApplyMetadata.visibleForGroups

> type: list of long (comma separated), required: no, default: -

Restrict the use of the plugin to this user group IDs (superadmins always see it in any case).

## Batch Search And Apply Metadata Providers

To create a new providers, create a sub-package of the core package (`ch.brix.batchSearchAndApplyMetadata.<sub-package-name>`) and implement the following interfaces.

```java
public interface SearchProvider {

    // name displayed in GUI
    String getSearchProviderName(Locale locale); 

    // description displayed in GUI
    String getSearchProviderDescription(Locale locale); 

    // search rules, returns result as string (displayed in GUI)
    String searchAssets(Credentials credentials, long rowNumber, List<String> row, ApplyMetadataProvider applyMetadataProvider); 
}
```

```java
public interface ApplyMetadataProvider {

    // name displayed in GUI
    String getApplyMetadataProviderName(Locale locale); 

    // description displayed in GUI
    String getApplyMetadataProviderDescription(Locale locale); 

    // apply rules, returns write counter
    int applyMetadata(Credentials credentials, Asset asset, List<String> row); 
}
```

## Example

A demo implementation can be found [here](https://gitlab.brix.ch/brix/celum/plugins/batch-search-and-apply-metadata-demo-providers).

In the demo case you can upload an excel / csv with two columns:

![excel](https://doc.brix.ch/user/pages/01.celum_extensions/76.batch_search_and_apply_metadata/excel.png)

The Demo Search Provider Case 1 searches assets with the following filters:

- nodetype 123
- dropdown infofield with index == 1
- noderef infofield with nodeId == 123456
- assets containing value from column A in infofield 1 and/or infofield 2

The Apply Provider writes the value from column B to infofield 3 of all assets that meet the above rules.

## Screenshots

![admin-menu](https://doc.brix.ch/user/pages/01.celum_extensions/76.batch_search_and_apply_metadata/gui_1.png)

![main](https://doc.brix.ch/user/pages/01.celum_extensions/76.batch_search_and_apply_metadata/gui_2.png)

![result](https://doc.brix.ch/user/pages/01.celum_extensions/76.batch_search_and_apply_metadata/gui_3.png)

## Compatibility Matrix

| Batch Search And Apply Metadata | CELUM (min. version) |
|---|---|
| 1.0.3 | 6.16 (tested with 6.16) |

| Nova Plugin | CELUM (min. version) | Backend Plugin (min. version) |
|---|---|---|
| 1.0.0-6.16.0 | 6.16.0 | 1.0.3 |

## Release Notes

#### 1.0.3

> Release: 2023-12-08

Initial Version

 [ ](https://doc.brix.ch/celum_extensions/shadow_assets/shadow_assets_vimeo) [](https://doc.brix.ch/celum_extensions/asset_report)

---

## Navigation

- Parent: [CELUM Extensions](https://doc.brix.ch/celum_extensions.md)
- Previous: [Shadow Assets](https://doc.brix.ch/celum_extensions/shadow_assets.md)
- Next: [Asset Report](https://doc.brix.ch/celum_extensions/asset_report.md)