> For the complete documentation index, see [llms.txt](https://nobraintools.gitbook.io/maya-groomers-tool/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nobraintools.gitbook.io/maya-groomers-tool/xgen-tools/xgen-rename-collection.md).

# XGen Rename Collection

<div align="left"><figure><img src="/files/ROtEvtZfvC5uYldSyJd5" alt=""><figcaption></figcaption></figure></div>

## Overview

This tool allows XGen artists to rename a collection when the base mesh name needs to change. It's ideal for studios adapting projects from others to fit their naming conventions. Designed to integrate easily into production workflows.

{% embed url="<https://youtu.be/8tDeWPil9tI>" %}

{% hint style="danger" %}
Before using this tool, it's HIGHLY RECOMMANDED to try it with a test file first to see if it works on your machine. You can download the '**renameTest.zip**' file and use that scene for testing this tool.
{% endhint %}

<div align="left"><figure><img src="/files/qVH0ppOxfbYPT2H7XPEY" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
If you have assigned Guide Colors using the Guide Color Tool, the renaming procedure will not function. Please remove the 'xgtGuideColor\_' expression from XGen's Expression tab and recreate the Guide Color layers
{% endhint %}

***

**Steps:** ​\
In my scene, there is one XGen collection (hair\_col), that is consists with two XGen descriptions (hairA\_des, hairB\_des) and each is bound to a scalp geo (baseA, baseB).

* In this scene I would like to rename my XGen Collection name from **hair\_col** to **bear\_col**

<div align="left"><figure><img src="/files/PoxYLdYhUmPzFnzgbx1y" alt=""><figcaption></figcaption></figure></div>

1. Do a Deep Backup

<div align="left"><figure><img src="/files/WQvEWm9b9UHBVnyRL4ti" alt=""><figcaption></figcaption></figure></div>

2. Open the XGen Guide Collection Rename Tool. Select the XGen Collection in the list that you wish to rename

<div align="left"><figure><img src="/files/YB4jMI7bUEEhitGlLhe7" alt=""><figcaption></figcaption></figure></div>

3\. Enter a new name.&#x20;

* The tool will go through a series of naming checks. If the renaming failed, please follow the warning messages.
* The name can not exist in any nodes in scene
* The name can not be the same as existing 'collection' or 'description' folders inside your current scene folder.
* The name can only start with alphabets

<div align="left"><figure><img src="/files/hn9lbzX8gjNezYLAbmrP" alt=""><figcaption></figcaption></figure></div>

4\. A prompt window will show up, by clicking **Yes**, you agree that due to many reasons, renaming can cause issues with XGen and you will be responsible for the damage caused to your work, if any.

<div align="left"><figure><img src="/files/IDRf0XgPpDcy3uHVic0o" alt=""><figcaption></figcaption></figure></div>

5. If successful, the XGen collection name will be renamed.

<figure><img src="/files/byN3AnKeR1ZBOcPOVfxt" alt=""><figcaption></figcaption></figure>

6. Test the scene to see if XGen is still working. Move the Guides, paint a map, refresh preview, etc. If anything goes wrong, please roll back the file using the deep backup tool.

***