# 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.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nobraintools.gitbook.io/maya-groomers-tool/xgen-tools/xgen-rename-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.