Skip to main content
Gainsight Inc.

Gainsight Objects

Gainsight provides the following objects as part of its Data Management:

  • Standard Objects
  • Custom Objects
  • System Objects

Standard Objects

All customer orgs are provisioned with four standard objects:

  • Company
  • User
  • Relationship
  • Relationship Type

These standard objects store important customer data like Company, Account/Relationship and user information in Gainsight's Matrix Data Architecture (MDA). This lets the users to perform actions from other functionalities in Gainsight application directly on the standard objects. These standard objects can be viewed under Data Management in Administration > Data Management as shown in the following image. For more information on the User object, refer Gainsight User Object.

A set of standard fields with predefined mappings are shipped by Gainsight. Customers can add custom fields, update schema of custom fields, and implement Read and Join tasks (from Reporting, CoPilot and Scorecards). Gainsight Connect helps you to import data from Salesforce to MDA standard objects. Admins can import data into the standard objects from a CSV file through S3 Connector and Gainsight Bulk API. Once data is imported into the standard fields, Admins cannot delete it. Admins can view the standard objects in Administration > Operations > Data Management.

Note: The standard objects are visible in the Rules Engine under the source only when there is an MDA join on Standard Objects. MDA standard objects include Picklist, User, Company, Relationship Type, and Relationship. You can import data in these objects using Gainsight ConnectGainsight S3 Connector, and Gainsight Bulk API.

These standard objects will have the following:

  Schema Editability? Data Editability?
Standard Objects Yes Yes
Standard Fields No Yes
Custom Fields Yes Yes

System Fields

  • GSID: Auto generated and unique

  • Created Date: System generated

  • Modified Date: System generated

No No


Data can be ingested into the standard objects using the following options:

  1. Gainsight Connect

  2. Gainsight S3 Connector

  3. Gainsight Bulk API

System Objects

These Objects are set up, shipped and controlled entirely by Gainsight. They are system driven and cannot be customised or modified by Admins. In these objects, neither the schema nor the data is editable. Data cannot be uploaded or deleted from system objects. A good example for a System Object is Zendesk (support ticket data). Admins can view the system objects in Administration > Operations > Data Management.

Custom Objects

Admins can create and edit the Custom Objects and can completely control them. In these objects, the schema is editable and the data can be uploaded, used, and deleted. Admins can manage the custom fields in Administration > Operations > Data Management. Data can be imported into the custom objects through Gainsight S3 Connector and Gainsight Bulk API.

  • Was this article helpful?