Skip to main content
Version: 8.1


This function is used in Python Scripting.


Renames a single tag or folder.

Client Permission Restrictions

Permission Type: Tag Editing

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.


system.tag.rename(tag, newName, [collisionPolicy])


StringtagA path to the tag or folder to rename.
StringnewNameThe new name for the tag or folder.
StringcollisionPolicyThe action to take when a tag or folder with the same path and name is encountered. Defaults to Abort. [optional]. Possible values include:
  • a - Abort and throw an exception
  • o - Overwrite and replace existing tag's configuration
  • i - Ignore that item in the list.


QualityCode - A QualityCode object that contains the results of the rename operation.


Gateway, Vision Client, Perspective Session

Code Examples

Example #1 - Rename a Folder
old = "[default]folder/tag"
new = "noun_1" # Note that the new name should not include the full path or tag provider. Just the name suffices.

system.tag.rename(old, new)


system tag rename, tag.rename