Skip to main content
Gainsight Inc.

Gainsight User Object

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 admins about the details of User object.


Gainsight User is a standard object to store user information in Gainsight’s Matrix Data Architecture (MDA). A set of standard fields with predefined mappings are shipped by Gainsight in the GS User object. Customers can add custom fields, update the schema of custom fields, and implement Read and Join tasks (from Reporting, Journey Orchestrator, and Scorecards). Every user record in this object is assigned a GSID and it is referenced in the rest of the system. Example: CSM in Company contains the GSID of the User, etc.

Note: Users in this object may or may not have a Gainsight license but the pre-defined data in Gainsight can be shared with the active users through the integrated features listed in this article.

Admins can view the User object in Administration > Data Management as shown below:

Additional Resource.png

Gainsight User enables users to:

  • Perform actions from other functionalities in Gainsight directly on GS User object.
  • Access Gainsight from outside of the application. Examples: to see predefined C360/R360 layouts by non Gainsight users.

Fields in Gainsight User

The Gainsight User object has the following set of System Fields and Standard Fields:

  • System Fields - These fields are system generated. You can neither edit the system fields nor ingest data into them through any data ingestion channel. You cannot see the system fields in the field mappings of any connector.
  • Standard Fields - these fields are provided out of the box by Gainsight. You cannot edit the standard fields. You can ingest data into these fields through the User Management page.
  • Custom Fields - You can create custom fields at Administration > Data Management > User Object and also ingest data to these fields.

Field Name



System Fields
Created Date DateTime Indicates when the record was created.
Modified Date DateTime Indicates the date when the record was last modified.
GSID GS ID GSID of a user record. For example: CSM field in the Company object has a look up to a record in the User object. This is generated automatically.
Standard Fields
Company ID GS ID This has a lookup to Company object and it has GSID of a company record.
Email Email Stores the Email address of a user. This field can also be used to store group Email to receive notifications for all users in the group (ex: dl-onboarding
External ID String A unique account identifier in an external system. It identifies an account uniquely apart from Email and Name.
First Name String First name of a user



Active (Display Name)

Boolean (True/False)

It indicates whether a user is active in Gainsight or not.

Note: IsActive (Deprecated) will be soon deprecated and this field is visible in Rules Engine, Data Management > User fields, Data Designer, and Reporting features.

Last Name String Last name of a user
Name String Name of a user
Manager GS ID This field helps Admins to create User - Manager hierarchies, ‘My team’, and ‘Portfolio view’ reports.
Timezone Dropdown list It stores the Timezone of a user’s location. Admins can ingest a user’s timezone value from the User Management page > Manual page and through Rules Engine (Load to User Action).
Username Email Stores username of a User. Username is unique in Gainsight and is used as a key to identify a user in Gainsight.
Is Super Admin Boolean (True/False) It indicates whether a user is identified as Super Admin who has superior permissions on Dashboards and Dashboard Folders. Super Admins have access to everything.
System Type Dropdown list Either Internal or External. A user is identified as an internal user when the user is part of your organisation. A user is identified as an external user when the user is part of your customer’s organisation. To enter external user information into User object, user’s organisation should have a record in the MDA object Company.

Admins can view the list of fields in User object in Administration > Data Management > [Click the object User] as shown below:

NXT GDM > User.gif

Channel to add Gainsight Users

You can add user records into the Gainsight User object from the Administration > User Management page. You can add user records by one of the three methods: either Manually, or through a CSV File, or from External Systems. For more information, refer to the Gainsight User Management article.

If you have questions or feedback about Gainsight User object explained in this article, please share them on

  • Was this article helpful?