Skip to main content
Gainsight Inc.

Migrate Picklists with X-Org

Gainsight NXT


​IMPORTANT: This article applies to the old version of X-Org. If you are using new version of X-Org, you can find the support documentation by clicking here.


This article explains the process of migrating Custom picklists using X-Org tool. X-Org is Gainsight's migration tool which can be used to migrate data from a source object to a target object. (Source object can be a sandbox org and target object can be a production org). To learn more about the X-Org tool refer to X-Org Migration Overview.

Migrate Custom Picklists

To Migrate Custom picklists using X-Org tool:

  1. Navigate to Administration > X-org Migration
  3. Enter the Tenant Id of the target org.
  5. Click the copy icon to copy the token and click CLOSE.

Note: If you have already generated the token for target org, you can use the existing token.

Screenshot 2023-03-01 at 3.07.12 PM.png

  1. Select New Migration from the ADD MIGRATION menu.
  2. Enter a name for the Migration.
  3. Enter the Migration Token.
  4. Click AUTHENTICATE. The Assets window is displayed.

Screenshot 2023-03-01 at 3.08.14 PM.png

  1. (Optional) Select the checkbox for the assets to be migrated.
  2. Click CONTINUE. The Configurations window is displayed.
  3. From the Select Entity Type drop-down menu, select COMPANY.

Screenshot 2023-03-01 at 3.11.36 PM.png

  1. Expand Picklist MDA and click Picklist MDA. You can view a list of Picklist items which are migrated and yet to be migrated.
  2. Select the Picklist MDA check box. All the picklists are selected. You can clear the check box for the picklists which are already migrated.
  3. Click CONTINUE.

Screenshot 2023-03-01 at 3.13.40 PM.png

  1. (Optional) Select the Objects to be migrated.
  2. Click CONTINUE.
  3. Ensure that all the assets selected for migration are displayed. In this case, Countries is picklist selected for migration.


  1. Click MIGRATE. The Migrate window is displayed.
  2. (Optional) Select the Test Run check box to perform a test migration.
  3. (Optional) Select the Send Copy of  Migration Status Email check box and provide recipient Email IDs to whom the migration results must be mailed.
  4. Click MIGRATE. The migration process starts.

Screenshot 2023-03-01 at 3.15.16 PM.png

  • Was this article helpful?