Data Spaces provide a virtual object structure that exposes a more consumable way to use data in Reporting and the Rules Engine. Admins no longer have to remember the object names and their lookups (object structure) each time they configure a rule, report, or relationship.

Key Benefits

  • While creating a report or a rule, Data Spaces reduces the complexity.
  • Whenever a Relationship Type is created, a default Data Space is created automatically for all the directly linked objects and for the relationship type.

For more information, refer to the Data Spaces Overview article.

This article covers the following topics:

Best Practices

  • Gainsight Object Glossary: use this table to better understand the main MDA and SFDC objects and fields used in Gainsight
  • Work with staff who have a strong understanding of and Gainsight object structure
  • Recommend mapping out the relationship path between the objects you want to include before you start to build
  • Think through the object chain you need from the “bottom up” – lowest level to the highest level
  • Data Space uses the data from the object the associating field lives on to the object it is looking up to (currently support 6 objects/levels in the chain)
  • If you use Filter in Data Space it will be used as AND between the Data Space and Rules or Reports
  • MDA must be authorized since metadata is stored there
  • Rules and Reports still require an Account Lookup on at least one of the objects in the Data Space

Data Space Creation

To create a Data Space:

  1. Navigate to Administration > Data Spaces.
  1. Click + DATA SPACE. The Data Space creation screen appears.
  1. Type a name and description for the Data Space.
  1. Select a base object from the Select Object list.


  • Start with the most detailed object at the lowest level that you want to use in your Data Space.
  • You can traverse up the chain to five levels only (not down). For example, if you are selecting CSTask as the base object, you can traverse only up to the Role object.
  • You cannot link two unrelated objects. For example, if you select the Usage object, you will not be able to get fields from the Survey object.
  • If you select the Account object as the base object, you cannot obtain fields from the CSTask or the Call To Action object.
  1. Once you select a base object, the lookup fields on the base object are displayed in bold, and a few fields from the selected base object/lookup field(non-bold) are also displayed. The bold fields indicate where you can add a related object.  
  1. Add the required fields under the Fields section by using the Add to Fields icon.
  2. Add the required filters under the Filters section by using the Add to Filters icon.



  • You can add up to 100 fields under Fields, and up to 26 fields under Filters.
  • You can also add advanced logic filters to the data space. Gainsight supports the configuration of advanced logic filters on data spaces. For example, Admins can apply an advanced logic filter to a data space to view the accounts where the ASV value is greater than or equal to 12000 OR the MRR value is equal to 500.
  1. Create a Dataspace with an advanced filter as specified in the following screenshot.

  1. Create a report on this data space with the Account, ASV, and MRR fields.  

The accounts where ASV  >= 12000, OR MRR = 500, are displayed in the report.

  1. Type a name and description for the Data Space. Or, click SAVE, which displays a pop-up to provide the Data Space name and Description; then click SAVE.
  1. The Data Space is created and appears in the Administration > Data Spaces list screen, as well as in the object selection in Rules and Reporting, along with other SFDC and MDA objects. On selection of that reporting space or in rule creation, we will show only the fields selected from Data Spaces.

    The Data Spaces list screen displays all Data Spaces in alphabetical order. Also, you can search Data Spaces using the following options:
  • Source Object: Searches Data Spaces by the base object name.
  • Name: Searches Data Spaces using the Data Space name.
  • Created By: Searches Data Spaces by the user names that created the Data Space, which are already populated in the drop-down box.
  • Last Modified by: Searches the last modified Data Spaces using the user names which last modified the Data Space, which are already populated in the drop-down box.

Use the Data Space in Report Builder

To use Data Space in Report Builder:

  1. After a Data Space is created, navigate to Report Builder.
  2. Click + REPORT.
  3. Select a data source from the list, which includes any newly created Data Spaces.
  1. Add fields in the Show Me and By fields.
  2. Click Apply to view results.

See Also:

Use Data Space in Rules Engine

In addition to SFDC and MDA objects, you can use Data Spaces as a data source in the rules engine by creating custom rules on Account. See Use Data Spaces in Rules Engine for a specific use case.

Note: You cannot create rules on Relationships using Data Spaces.


Use Data Space in Journey Orchestrator

You can create a Power List for a relationship type. This power list can be generated using the Data Spaces associated with the selected relationship type. For example, if you have Relationship Contact (likely to have an email ID field in it) as a linked object, you can use the associated default Data Space ([Relationship Type name + Relationship Contact]) to filter out contacts for your Power List.

In addition, if you want to select contacts from a specific Data Space, for example, ([Relationship Type Name + CTA]), then select the appropriate Data Space and add additional criterias. This strategy helps you fetch contacts from filtered relationships.