AgentFoundrySign in ↗
← All examples

blender tools

Batch rename objects by rule

Rename many objects at once by rule: strip .001 suffixes, find and replace with optional regular expressions, apply a case style, add a prefix and suffix, and number only the names that would collide. Use it to prepare scenes for export and naming conventions.

Recorded render of Batch rename objects by rule

What this component contains

  • ATTRIBUTION.md
  • LICENSE
  • README.md
  • component.json
  • graphcheck.py
  • meshcheck.py
  • preview.png
  • test_package.py
  • test_util_batch_rename.py
  • util_batch_rename.py
  • verification/native.json

How it works

Operator
baltor.util_batch_rename
Parameters
prefix, suffix, find, replace, use_regex, case, strip_duplicate_suffix, numbering and 5 more
Result
Objects renamed in place; the plan is returned as a report.
Blender
4.2 or later
Axes
Blender Z up, -Y forward
Units
metres

Recorded checks

blender 5.2.1 LTS (hash 9e2066aef7ef built 2026-08-25 02:12:34)

  • addon_install_and_enable
  • operator_runs_with_defaults
  • blender_data_matches_core
  • addon_disable_unregisters
  • script_mode_runs
  • clean_reopen_addon_file
  • clean_reopen_script_file
  • gltf_separate_export
  • engine_output_clean

Limits to consider

Renames objects and, when they have a single user, their data; materials, collections and other data blocks keep their names. Case splitting is a heuristic for ASCII words and digit runs. Names are cut to 63 bytes, so very long names lose their end. Regular expressions use Python syntax. Verified in Blender 5.2.1; written for the 4.2 API.