Gainsight User Object
Gainsight NXT
This article explains admins about the details of User object and the various channels to add users in Gainsight.
Overview
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.
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 |
Datatype |
Description |
|---|---|---|
| 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. |
| 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 @sample.com) | ||
| 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 |
|
IsActiveUser or 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 | 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 the Gainsight User object, user’s organisation should have a record in the MDA Company object. |
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 community.gainsight.com.
Additional Resources
For more information on managing data in Gainsight, refer to the following articles: