Skip to main content
Gainsight Inc.

Migrate Picklists with X-Org

Gainsight NXT

This article supports Gainsight NXT, the next evolution of the Customer Success platform. If you are using Gainsight CS Salesforce Edition, you can find supporting documentation by visiting the home page, and selecting CS > Salesforce Edition.

Not sure what your team is using? Click here.



This article explains you 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 Cross-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.

1. Xorg_1.gif

  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.

2. Picklist Migration.gif

  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.

3. Xcompanu.gif

  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.

4. pICK_2.gif

  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.

6. Migrate surveys.gif

  • Was this article helpful?