Skip to main content


Gainsight Inc.

Create Scorecards

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 is the third item in a series of Scorecard configuration articles. Gainsight recommends you to refer the initial articles of the series and then start with this article. This article explains all the options available to configure Scorecards.
Once you configure Measures and Grading scheme, you can create and configure Scorecards. A Scorecard consists of Measures, or Measures Groups, or a combination of both. You can include any of the Measures or Measure Groups created on the Measures tab, in your Scorecards. By default, an overall score is present for every Scorecard. The overall score can be auto calculated and depends on the individual Score of all the Measures, which are included in the Scorecards.

Important notes:

  • You can create a Scorecard for a Company or a Relationship
  • A Company Scorecard can only include those Measures and Measure Groups which were created for a Company; Similarly, Relationship Scorecards can include only Relationship Measures and Measure Groups.
  • A Scorecard for a Company and relationship can have the same name, since they are created for different entities.
  • You can create reports based on the Scorecard data.

Create Scorecards

To create a Scorecard:

  1. Navigate to Administration > Health Scoring > Scorecard. The Scorecard window is displayed.
  2. Click the SCORECARDS tab.
  3. Click + SCORECARD.

1. Navigate to Scorecards.gif

You must configure the following three sections in Scorecards.

  • Properties
  • Configuration
  • Applies to

Properties Section

In this section, perform the following tasks:

  1. Enter a name for the Scorecard, in the Scorecard name field.
  2. Select either Company or Relationship option in the Scorecard applies to field. You cannot modify the value in this field after you save the Scorecard.
  3. Select a scheme from the Scheme type drop-down menu. The available schemes are:
  • Numeric
  • Color
  • Grade

To learn more about Scorecard Schemes, refer the Configure Scorecard Schemes article.

  1. Select the Default Scorecard check box, to set this scorecard as the default Scorecard. The default Scorecard plays a crucial role while assigning Scorecards to Companies or Relationships. For more information on Default Scorecard and Scorecard assignment process, refer the Working with multiple Scorecards article.
  2. Select the Enable overall rollup check box, to ensure that the individual scores of each Measure (included in the Scorecard) are integrated to form an overall score for the Scorecard. The integration is performed based on the Weightage assigned to each Measure.
  3. Select the Enable group scores check box, to ensure that the individual scores of each Measure (included in the Group) are integrated to form an score for the Group. The integration is performed based on the Weightage assigned to each Measure.
  4. (Optional) Enter a description in the Scorecard description field.

2. SP.png

Configuration Section

In this section, perform the following tasks:

  1. Drag and drop the required measures from the left pane.

3. Add Measure.gif

  1. Click + GROUP to add a new group.
  2. Select a Measure Group from the list.
    1. Drag and drop the Measures which must be part of the Group.

4. Measure group.gif

The example Scorecard has one Measure called Customer Sentiment and a Measure Group called Support tickets. This group has two measures: JIRA tickets and Zendesk tickets.

Note: You can also directly drag and drop individual Measures into the Measure Groups and vice versa.

Measures into Measure Groups_NXT.gif

  1. (Optional) Click the T icon (help text) on the right corner of a Measure to configure the help text. You can configure help text for each Score Range. In the below image, help text is configured for the Customer Sentiment Measure.

help text.gif

The help text you configure here, appears on the Scorecard Mass Edit report, when you use the slider to modify the score for the Measure (Customer Sentiment).

mass Edit help text.gif

  1. (Optional) Click the X icon on the right corner to remove the respective Measure from the Scorecard.
  2. Click WEIGHTS. The Configure Weights window is displayed.
  3. Enter the weight for each Measure in the Weights column. To learn more about configuring Weights, refer the Measure Weights article.
  4. Click SUBMIT.

New Configure Weights Screen1_NXT.gif

  1. Click VALIDITY TYPE. The Validity Period window is displayed.
  2. Select the Validity Type and Validity Period for each Measure. Once the Validity period has passed, the Measure displays a stale score.  
    For example, if you set the Validity Period for 1 week on 1 Dec 2018. Your score is valid for 1 week till 7 dec 2018. However, if you modify the score on the 6th Dec 2018, the validity is extended for one more week, starting from 6th day. The new Validity Period would be 6 Dec 2018 - 12 Dec 2018. If you update the Score within the Validity Period (6-12 Dec), the Validity is extended by another week, starting on the date on which the Score was modified. This rule applies for other Validity Type also.

6. Validity types.gif

  1. Click EXCEPTIONS. The Configure Exceptions window is displayed.
  2. Configure the Exception as shown in the below image.

7. Exceptions.gif

In this case, an Exception has been set such that, if Customer Sentiment measure’s score is greater than or equal to 79, Overall Score is also equal to 79, irrespective of Weightage configured.  To learn more about Exceptions, refer the Exceptions in Scorecards article.

Configure Criteria

The Criteria section allows you to define various conditions. If a Company or a Relationship can satisfy these conditions, then this scorecard is applied to the respective Company or Relationship. The default Scorecard is not applicable to such Company or Relationship. You can add all the Company or Relationship fields as source for the criteria.

To configure a Criteria:

  1. Click + ADD CRITERIA.
  2. Form the required criteria by selecting the required fields and operators.
  3. (Optional) Click + ADD CRITERIA, to add more criteria.
  4. Click SAVE, to save the Scorecard.

A prompt box appears on the window. If you select the Yes option, the changes are applied immediately to the Company and Relationships. However, if you select No, the changes are applied when the Scorecard Resolver runs.  

8- Criteria.gif

This Scorecard would now be applied to all the Companies with 10,000 or more employees.

Scorecard Resolver

The Scorecard Resolver executes at 23:59 hours, by default. You can change the execution time. Any modifications made to the Scorecard Criteria are applied when the Resolver runs.

To configure Scorecard Resolver:

  1. Click the Calendar icon.
  2. Change the time, if required.
  3. Click SAVE.

9- Scorecard scheduler.gif

Scorecard Fact Object   

The Scorecard Fact object creates new objects dynamically, whenever you create a new Scorecard. For instance, if your Scorecard name is Company Scorecard, a new object is created with the name Company Scorecard Fact. You can use this object to prepare scorecard reports.

  • Was this article helpful?