Go to: Synopsis. Return value. Keywords. Related. Python examples.



Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

renameAttr is undoable, NOT queryable, and NOT editable.

Renames the given user-defined attribute to the name given in the string argument. If the new name conflicts with an existing name then this command will fail. Note that it is not legal to rename an attribute to the empty string.

Return value

stringThe new name. When undone returns the original name.


node, connection, rename, attribute, dynamic


addAttr, aliasAttr, attributeInfo, copyAttr, deleteAttr, getClassification, listAttr, nodeType, objExists, objectType, setAttr

Python examples

import maya.cmds as cmds

cmds.sphere( n='sph' )
cmds.addAttr( sn='ms', ln='mass', dv=1.0, min=0.001, max=10000 )
# Rename the long and short names separately
cmds.renameAttr( 'sph.mass', 'length' )
cmds.renameAttr( 'sph.ms', 'ln' )