---
title: "system.tag.rename"
description: "Renames a single tag or folder."
---

# system.tag.rename

> Renames a single tag or folder.

This function is used in **Python Scripting**.

## Description
## Client Permission Restrictions
[Permission Type](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties): 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.

## Syntax
`system.tag.rename(tag, newName, [collisionPolicy])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `tag` | A path to the tag or folder to rename.
String| `newName` | The new name for the tag or folder. 
String| `collisionPolicy` | The 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 exceptiono - Overwrite and replace existing tag's configurationi - Ignore that item in the list. 
	
### Returns
**QualityCode** - A QualityCode object that contains the results of the rename operation. 
	
### Scope
Gateway, Vision Client, Perspective Session

## Code Examples
```python title="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)
```