> 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2F20R3mjD0pxPSa7t6AU0P%2FxgtRenamePalette.jpg?alt=media&amp;token=01bc67a3-f24e-45a2-8f27-f29c19ff70b2" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FuLk6Ql6eMsdbG5yNxPPt%2FreameTest.jpg?alt=media&amp;token=5bcd5a4e-d791-4019-99a0-ffc808099aab" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FQ2EkxU4bcF85dLtL582o%2Frenamecol-1.jpg?alt=media&amp;token=ed10248a-e0aa-4bfe-bfd6-377c96717c9a" alt=""><figcaption></figcaption></figure></div>

1. Do a Deep Backup

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FPxHfIakMQVHUGWhDZtt9%2Frenamecol-2.jpg?alt=media&amp;token=3843dd5d-7c2b-4180-b29f-e5b9ad19a2c6" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FkCI5tLk4SOAz9Jl5SFdQ%2Frenamecol-3_orig.jpg?alt=media&amp;token=c9d916da-ad1b-4024-8dcc-edf42fb376c3" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FVJbZZe1yCbEEFxqn8qPv%2Frenamecol-4_orig.jpg?alt=media&amp;token=5d756b8c-6004-46de-bb6d-039ab5d2c018" 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="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FrTeMgeE9ph3Nlquvhhsj%2Frenameagreement-1_orig.jpg?alt=media&amp;token=8c469f17-a3fc-4b86-ade4-11f51b0909b8" alt=""><figcaption></figcaption></figure></div>

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

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FqGgWdQ9bsu4oPRg0ipaL%2Frenamecol-5_orig.jpg?alt=media&amp;token=fd7c6aa4-1cc6-4560-a15b-7f5847355092" 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.

***