# XGen Rename Description

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FrvYc5ZHzDFViD8DxgYRJ%2FxgtRenameDes.jpg?alt=media&#x26;token=40ea1ffc-3105-4b17-8f07-b5f79832d3b4" alt=""><figcaption></figcaption></figure></div>

## Overview

As an XGen artist, you may find that you need to rename an XGen description for various reasons. This tool is specifically designed to streamline the renaming process and integrate seamlessly into your production workflow, preserving as much data as possible.

{% 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%2Fdgkdz6LDkxR0mgnCAwQw%2FreameTest.jpg?alt=media&#x26;token=8c435738-19a0-4187-bb3d-d4d44e4630cb" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
* **If you have any Guide Colors assigned using the Guide Color Tool, renaming procedure will not work. Please delete the 'xgtGuideColor\_' expression from XGen's Expression tab, and recreate the Guide Color layers again.**
* **Please be aware that, renaming a description will break all the guide color layers assigned using the Guide Color Tool, as after a rename, the description name will not sync with the guide layer names anymore.**
{% endhint %}

***

**Steps:** ​\
In my scene, there is one XGen collection (bear\_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 Description names from **hairA\_des** and **hairB\_des** to **bodyFur\_des** and **pawFur\_des**.

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&#x26;token=3843dd5d-7c2b-4180-b29f-e5b9ad19a2c6" alt=""><figcaption></figcaption></figure></div>

2. Open up the XGen Guide Rename Description Tool. Select a description on the list.

3\. Enter a new name. Click **Rename**

* 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%2F0HXkTnO3wQ7wcJf8Aaex%2Frenamedes-1_orig.jpg?alt=media&#x26;token=8229e06a-4321-4367-8d44-49d71a843f32" 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%2FB2O0PORR1dV2VeGXfANt%2Frenameagreement-1_orig.jpg?alt=media&#x26;token=56780e37-4cfe-43e5-8b33-a59d91bd215d" alt=""><figcaption></figcaption></figure></div>

5. After renaming, the primitives changed its color in viewport. This is because the shader assignment has been lost after renaming. Please re-assign the material back.

<div align="left"><figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FM9GldE2sU70dyGYM4crP%2Frenamedes-2_orig.jpg?alt=media&#x26;token=7946077f-12e5-4482-b4fe-d88358a5a456" alt=""><figcaption></figcaption></figure></div>

6. Repeat to rename the other descriptions. You can only rename one description at a time.

<figure><img src="https://454332562-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyyK7o0fNRXvtva8vEkG%2Fuploads%2FIVgqapHwDVlxSWdzV26Y%2Frenamedes-3_orig.jpg?alt=media&#x26;token=5fbcf34a-f664-4d06-9a26-016e02cac75a" alt=""><figcaption></figcaption></figure>

7. Please test the scene to see if XGen is still working. Move the Guides, paint a map, refresh preview, etc. If anything goes wrong, please try using the deep back tool to roll back to the previous scene.

***

