batch-rename-elements

Batch Rename Elements

Rename Revit elements in bulk for:

"$ARGUMENTS"

Before writing code

Ask (one question only if ambiguous):

1. Which category? Rooms, Views, Sheets, Doors, Levels, Grids, or another?
2. What's the naming pattern? Prefix + number? Parameter-driven? Find & replace? Sequential?
3. What parameter holds the name? Usually Name for rooms/views, Sheet Number+Sheet Name for sheets.

Default: produce a complete, ready-to-run Dynamo script.

---

Standard rename patterns

Pattern A — Add prefix/suffix to all elements in a category

import clr
clr.AddReference('RevitServices')
from RevitServices.Persistence import DocumentManager
from RevitServices.Transactions import TransactionManager
clr.AddReference('RevitAPI')
from Autodesk.Revit.DB import *

doc = DocumentManager.Instance.CurrentDBDocument

# ── Configuration ────────────────────────────────────────────────────────────
CATEGORY    = BuiltInCategory.OST_Rooms   # change to target category
PARAM_NAME  = "Name"                       # parameter that holds the name
PREFIX      = "A-"                         # set "" to skip
SUFFIX      = ""                           # set "" to skip
# ─────────────────────────────────────────────────────────────────────────────

try:
    elements = (FilteredElementCollector(doc)
                .OfCategory(CATEGORY)
                .WhereElementIsNotElementType()
                .ToElements())

    renamed = []
    skipped = []

    TransactionManager.Instance.EnsureInTransaction(doc)

    for el in elements:
        param = el.LookupParameter(PARAM_NAME)
        if param and not param.IsReadOnly:
            old_name = param.AsString() or ""
            # Avoid double-prefixing on re-runs
            if not old_name.startswith(PREFIX):
                new_name = PREFIX + old_name + SUFFIX
                param.Set(new_name)
                renamed.append(old_name + " → " + new_name)
            else:
                skipped.append(old_name + " (already prefixed)")

    TransactionManager.Instance.TransactionTaskDone()

    OUT = {
        "Renamed": renamed,
        "Skipped (already prefixed)": skipped,
        "Total renamed": len(renamed)
    }

except Exception as e:
    TransactionManager.Instance.ForceCloseTransaction()
    import traceback
    OUT = "ERROR: " + str(e) + "\n" + traceback.format_exc()