Batch Edit Library Elements

The Batch Edit feature allows you to modify attributes of multiple library elements at once using search-and-replace operations. This is useful when you need to rename, re-version, or update descriptions across many library elements simultaneously.

Opening the Batch Edit Wizard

You can open the Batch Edit wizard in two ways:

In the Library Manager, select one or more library elements in the tree view (use Ctrl+Click or Shift+Click for multi-selection)
Right-click to open the context menu
Click Batch Edit...

Select one or more library elements in the tree view
Click the Batch Edit... button in the Library Manager toolbar

The Batch Edit option is only available when library elements are selected.

Step 1: Configure the Edit Operation

The first page of the wizard lets you choose what to change and how.

Select an Attribute

Use the Attribute dropdown to choose which property to modify:

Name — the library element name
Key — the library element key (unique identifier)
Description — the library element description
Version — the library element version
Revision — the library element revision

Only one attribute can be modified per wizard run.

Select an Operation

Use the Operation dropdown to choose the type of modification:

Operation	Description	Example
Find & Replace (Literal)	Replace exact text matches	"v1" → "v2"
Find & Replace (Regex)	Replace using regular expression patterns	"v[0-9]+" → "v2"
Add Prefix	Add text to the beginning of each value	Add "NEW_" → "Bay1" becomes "NEW_Bay1"
Add Suffix	Add text to the end of each value	Add "_rev2" → "Bay1" becomes "Bay1_rev2"
Remove Prefix	Remove text from the beginning of each value	Remove "OLD_" → "OLD_Bay1" becomes "Bay1"
Remove Suffix	Remove text from the end of each value	Remove "_rev1" → "Bay1_rev1" becomes "Bay1"
Set Fixed Value	Set all elements to the same value	Set "2.0" → all versions become "2.0"

Enter Values

Depending on the selected operation, you will see one or two input fields:

Find & Replace: Enter the text to find and the replacement text
Add/Remove Prefix/Suffix: Enter the prefix or suffix text
Set Fixed Value: Enter the value to set

For Regex operations, the find field accepts Java regular expression syntax. Invalid patterns are flagged immediately with an error message.

Click Next to preview the changes.

Step 2: Preview and Apply Changes

The second page shows a table with all proposed changes:

Column	Description
Library Element	The element key (and name) being modified
Old Value	The current attribute value
New Value	The proposed new value (highlighted in yellow)

Elements where the operation would not result in a change are automatically excluded from the list.

Actions

Finish — Apply all listed changes. The entire batch is applied as a single operation and can be undone with Ctrl+Z
Back — Return to the edit page to modify the operation (e.g., try a different find text)
Cancel — Discard all changes and close the wizard

If no changes would result from the operation (e.g., the find text does not match any values), a warning is shown and the Finish button is disabled.

Tips

Multi-select: Hold Ctrl and click to select individual elements, or hold Shift to select a range
Iterative refinement: Use the Back button to adjust your operation after reviewing the preview
Undo: All changes from one wizard run can be undone with a single Ctrl+Z
Regex examples:
- Bay[0-9]+ matches "Bay1", "Bay42", etc.
- ^OLD_ matches "OLD_" only at the start of a value
- _v[0-9]+$ matches version suffixes like "_v1", "_v23" at the end