Skip to main content
Gainsight Inc.

Survey Flattening Overview

This article explains the basics of how Survey Flattening operates within Gainsight. By default, survey response data is spread out among several objects. Survey Flattening places this information into a single MDA object formatted with survey respondents in rows and each question in its own column to allow for easy reporting and insights into survey data.


Enable Survey Flattening

Survey 1.0

Survey Flattening will need to be turned ON within the Properties section of each survey. For more information on the properties section, refer to Configure Survey Properties.

IMPORTANT: Only enable survey flattening after your survey question configuration is finalized.


After the survey flattening has been turned on, click the option Reset the flattened reporting and click SAVE. This automatically creates a new MDA object with the same name as the survey suffixed with Flattened


You will now see the new Survey object in the MDA table as Survey Name-Flattened.


After this process has been completed, your flattened survey data is now available in Report Builder under the object name Survey Name-Flattened. The table will contain information such as survey questions, recipient responses, and the response date. For more information on building reports in Gainsight, see the path How to Build Reports.


Survey 2.0

Survey Flattening is enabled by default for Survey 2.0. An object containing response data for the survey will be created after the survey receives its first response. To create a report on a flattened survey 2.0 object, navigate to Administration > Report Builder, and select the object with the same name as your survey.

Surveys that are migrated from survey 1.0 to survey 2.0 have their dedicated survey flattened table in MDA. These survey flattened objects are labeled as MIG-XXX.

FLattened [3].png

Reset Flattened Table

Survey 1.0

The MDA table created through this process will flatten new data automatically through a job running in the background. The sites used for flattened surveys will need to be secure in order for this functionality to work properly. When survey responses are logged the flattened survey table is updated with the response in as close to real time as possible. The use of a secure site is required for this update to complete on the backend of the system.

You can identify secure sites by locating https:// at the beginning of their URL. To learn more about setting up survey sites, see the article Setup Salesforce Survey Domain & Test Survey Setup.

Users can also manually refresh the table with up-to-date data. Click Reset the flattened reporting under the survey’s properties to to reload the data for that specific survey. 

You can see a message displaying 'Request to reload data in Survey Name-Flattened initiated, will be notified via email once completed' at the top of the page. Here, 'Summer CSAT Survey-Flattened' in the message is the name of the survey.


  • The option to manually refresh the table is only available for Survey 1.0.
  • It is not possible to add or edit fields within the flattened MDA object.


Survey 2.0

The MDA table created through this process will flatten new data automatically through a job running in the background.

Users can also manually refresh the table with up-to-date data. Click Reset Flattening, to reload the data for that specific survey. You can see a message displaying ‘Request to reload data in MVP NPS® Survey initiated, will be notified via email once done’ at the bottom of the page. Here, 'MVP NPS® Survey' in the message is the name of the survey.

Reset name.png

Once the data is reloaded, you will receive an email notification.

Reset mail.png

Using Flattened Labels

A flattened survey will have each survey question saved as a separate column within the flattened MDA table. By default, the header of this column will be the full text of the survey question. Since the full length of a question would often be difficult to display in a report, users have the option to change the label of the question column.

Surveys 1.0

Question labels be configured by locating the “Flattened Label” field within the question’s settings.


This label will then be reflected in the table:


Survey 2.0

Flattened objects based on Survey 2.0 surveys will have the same name as the survey. It is not possible to change this object name at this time.

You can update the label of any survey question within the flattened object by editing the questions Flattening label. To access the Flattening label, navigate to Survey 2.0 > Design > edit the question and update the Flattening Label text under Settings.


For more information on editing 2.0 survey questions, refer to Survey 2.0 Design.

NPS, Net Promoter, and Net Promoter Score are registered trademarks of Satmetrix Systems, Inc., Bain & Company and Fred Reichheld.
  • Was this article helpful?