Skip to main content
Gainsight Inc.

Gainsight Assist Chrome Plug-in User Guide

Gainsight NXT


This article provides an overview of the Gainsight Assist Chrome Plug-in. It also explains how users can compose and send emails from their Gmail account using Gainsight templates, and easily sync them to Timeline directly from Gmail.


The Gainsight Assist Chrome plug-in helps users manage their day-to-day customer communications and saves them time and effort. Users can access their Gainsight email templates directly from Gmail, thereby saving time when composing customer emails and helping to drive consistency in communications. Also, the ability to log emails to Timeline from their inbox saves time and ensures that every important conversation is captured. For more information about how Gainsight Assist Chrome Plug-in works, see Intro to Gainsight Assist Chrome Plug-in (4 min. video)

Note: This plug-in is not supported for emails that are sent using the Schedule Send option in Gmail.

Business Use Cases: 

  • As a user, while composing an email from Gmail, I want to access the email templates my admin has created in Gainsight to save time and effort.
  • As a CSM, I want to log all of my customer communications/emails from Gmail to Timeline using the logged-in user credentials.

Users must install the Gainsight Assist Chrome plug-in from the Chrome Web Store. After installing the plug-in, refresh your Gmail account to view the Gainsight logo and sidebar.



Following are some of the limitations in using Gainsight Assist Chrome Plug-in:

  • Gainsight does not support any Chrome external extensions that modify the Gmail theme; activities will be logged with the default Gmail theme.
  • Inactive companies will not be shown in the company or relationship search from the plugin to log the activity.

Gainsight Assist Plug-in

Access to the Gainsight Assist Chrome Plug-in is restricted to the users who use the plug-in directly from or However, users will still be able to use the plug-in if any Gainsight user has registered their Gmail ID with Gainsight.


Note: If users have different email IDs for both SFDC and MDA accounts, then both email IDs are allowed to log in.

If users installed the plug-in from the Chrome store and have not logged in to the plug-in yet then the Gainsight Assist Plug-in logo on the Chrome toolbar is indicated in Red.


If they have logged in successfully then the plug-in logo on the Chrome toolbar changes to Green.


Login Process for Chrome Plug-in

Gainsight Assist plug-in provides the following integrations:

  • Gainsight Account (For NXT customers): Use your Gainsight NXT account, if you want to access Gainsight directly outside your platform. For more information on types of authentication methods, refer to the User Login Methods to Gainsight NXT article.
    ​​​​​​​Note: If users face errors after logging in, navigate to Privacy and Security section of the General settings page of Chrome browser and enable the Block third-party cookies in Incognito option.
  • Salesforce Account: Use the Salesforce account, if you use Gainsight from the Salesforce platform. If this option is selected, it directly asks for the user credentials.

Users can log into Gainsight Assist Plug-in based on which of the following category they belong to:

Users with a Single Domain

Users that have a single domain can log in using the following steps:

  1. Click the Gainsight icon on the Gmail slide-out panel. The Login page appears.
  2. Click Gainsight integration.
  3. In the Username field, enter the username.
  4. Click Next. The Gainsight login window appears.
  5. Enter Username and Password of your Gainsight account.
  6. Click LOG IN. The Welcome to Gainsight page appears.

Note: If a user is already logged in to a domain, then the Gainsight Assist plug-in automatically redirects to the Welcome to Gainsight page.

Users with a Single Domain and Multiple Environments

Users that have a single domain and have access to multiple environments such as Production or Sandbox orgs, can log in using the following steps:

  1. Click the Gainsight icon on the Gmail slide-out panel. The Login page appears.
  2. Click Gainsight integration.
  3. In the Username field, enter the username.
  4. Click Next.
  5. From the Select domain dropdown, select the required domain.
  6. Click Next. The Gainsight login window appears.
  7. Enter Username and Password of your Gainsight account.
  8. Click LOG IN. The Welcome to Gainsight page appears.

Users with Multiple Domains

Users that have multiple domains can log in using the following steps:

  1. Click the Gainsight icon on the Gmail slide-out panel. The Login page appears.
  2. Click Gainsight integration.
  3. In the Username field, enter the username.
  4. Click Next.
  5. In the Gainsight Domain field, enter the Gainsight domain URL.
  6. From the Choose Data Center Location dropdown, select one of the following options:
    • US1 Data Center: Covers the US Region and contains data specific to the existing US customers only.
    • US2 Data Center: Covers the US West 2 Oregon region and contains only new US customers' data.
    • EU Data Center:  Contains customer data specific to the EU region.
  7. Click Next. The Gainsight login window appears.
  8. Enter Username and Password of your Gainsight account.
  9. Click LOG IN. The Welcome to Gainsight page appears.

Chrome Plug-in Updates

In Gmail, a pop-up dialog appears at the plug-in logo if there are any updates available for the Gainsight Assist plug-in to be downloaded. However, if the updates are not mandatory, users can still use the plug-in.


But, if the updates are mandatory, users cannot use the plug-in unless the updates are downloaded. If users open the plug-in, the update pop-up appears without the Close (X) option. Click Open Extension to navigate to the Chrome Plug-in extension updates page.

Note: After downloading the updates, Gainsight recommends you turn off the Developer Mode toggle switch.


Template Selection for Composing Emails

When the email composer is opened, all the Gainsight email templates which can be accessed by the user are displayed in the side panel, sorted on the basis of the last modified date. All the attachments, images, and tokens (except the report and survey) are supported by this feature.

Note: Only the templates with the Available to Users toggle switch ON are displayed. For more information, refer to Restrict Email Templates Available in Send Email Service section.

The email templates displayed in the slide-out panel cannot be edited from the plug-in. However, the content in the template can be edited once they are moved to the composer.
Note: Gainsight recommends editing Button text in Gainsight Org to ensure that the hyperlink in the text is not broken.

To use an email template:

  1. Click Compose. The Gainsight Chrome plug-in slide-out panel appears.
  2. Expand the list of folders from which the template is to be added.
  3. Select the required email template. Email template Preview appears.
  4. (Optional) From the version dropdown, select the required template version.
  5. Click Apply.
  6. Click Done.

You can also apply email templates when using the email composer window in maximize state as well. If you do not want to use Gainsight templates, click the minimized icon of the Email Templates section. 



The following are some of the limitations of viewing Gainsight email templates in the plug-in:

  • Users can view both the Operational and Non-Operational templates. For non-operation templates, the unsubscribe option is not available.
  • Templates with Survey and Report tokens are not displayed.
  • Customer info object is not supported for token resolution in the Chrome Plug-in. Company, Relationship, Person, Company Person, Relationship Person, and Relationship Type are the only objects supported.

Composing Emails

To resolve tokens dynamically that are mapped to default mapping in email templates while editing a token, enable the Edit default token mapping in cockpit toggle button in the Administration > Email Configuration > Compliance tab.

To compose emails using Gainsight Assist plug-in:

  1. Click the GS Assist Plug-in icon on the side panel. The Welcome to Gainsight page appears.
  2. Click Compose or Compose a mail. The New Message window appears along with the list of Email Templates from Gainsight in the side panel.
  3. Click on the template you want to use. 

Note: Users can also search through the list of templates by complete name and select a particular template.

  1. In the Primary Recipient field, enter the email address of the recipient to automatically resolve the tokens.

Note: The search in the Primary Recipient field occurs on Company Person object and also the Permission Bundles are honored in the search. However, when the Log to Timeline resolution happens, the search is based on the Company Person object and it does not honor the Permission bundles.

  1. Click Apply Template. The template from the side panel is copied to the email composer and a successful message appears.
  2. Click Done.


Important Notes: The following are some of the important points when composing an email using templates from plug-in.

  • Users can directly click the Apply Template option without providing primary recipient details to edit the tokenization values manually.


  • You can also add multiple email templates to a single email by placing the cursor in the composer, at the point you want to add content in the email. 


  • If a user adds the primary recipient in the composer and then click on the template, the email address provided in the composer is automatically copied to the Primary Recipient field in the plug-in sidebar.


  • When the recipient copied from the composer to the primary recipient, after which the primary recipient is modified, the new recipient is copied to the recipient list to the composer and added as the last recipient when the template is applied.


  • The email ID added as primary recipient from the plug-in is copied to the To field in the Composer even though the recipient is not found while searching in the Primary Recipient field.


  • If the email ID belonging to the same Company and Relationship is added to the primary recipient search box, a dropdown list with the options is displayed for the users to select the correct email ID.


  • You can also apply Gainsight email templates while replying to the existing emails.

Log to Timeline

Users can sync emails to Timeline directly from Gmail when they send out the email. These emails are logged to the Timeline, and its status is updated in Gmail. Also, the Log to Timeline feature from the plug-in is applicable for older emails as well. These logs are added as an activity to the user's company Timeline.

Note: The email is not logged to Timeline if:

  • Subject line exceeds more than 256 characters. 
  • The body of the email exceeds more than 32K characters.

Log Emails To Timeline

The Log to Timeline checkbox is not selected by default. If you want to log emails to Timeline, select the Log to Timeline checkbox before sending out the email.


The Log to Timeline window is displayed when the Log to Timeline checkbox is selected and users click Send.

Log to Timeline.png

When the Log to Timeline checkbox is selected, the following scenarios arise:

  • If all the recipients are from the same Company/Relationship, Gainsight resolves the Company/Relationship details that are required to log the email against the Timeline.

  • If there are any resolution conflicts, the Log to Timeline dialog appears after clicking Send, displaying the email recipients as well as the Company/Relationship to which they belong to. Select the Company/Relationship to which the email must be logged.

  • If the required Company/Relationship is not listed, users can use the Search icon to find a Company/Relationship to add, and then log the email against this Company/Relationship.

  • If the user does not resolve and directly sends the email, the email is saved in the drafts section of the Timeline. Users have to log that email manually by logging into the Gainsight application. 



  • ID used to log into Gainsight org will be logged to Timeline as internal attendee.
  • Email IDs not recognized as Internal, or Company / Relationship Person will be logged as External IDs.
  • When emails in the Inbox are logged to Timeline, following IDs are resolved:
    • From email ID
    • To recipients
    • CC recipients
    • BCC recipients
  • When an email is composed, the following IDs are resolved:
    • To recipients
    • CC recipients
    • BCC recipient.
  • For sent emails, the following IDs  are resolved:
    • To recipients
    • CC recipients
    • BCC recipients

IMPORTANT: If a user sends an email to multiple users:

  • Any user can log the email as an activity.

  • The status of that email is changed to logged for all the users if one user logs that email to Timeline. 

  • Once the email is converted as an activity, all the users view the email status as Logged. The user who has already created a draft of that email has two entries, one as a draft and another as an activity.

Users can also log older emails to Timeline by clicking on the Log to Timeline button, which is available if that email is not already logged to Timeline. 


To log older emails to Timeline:

  1. Open an older email you want to log to Timeline.

  2. Click the Log to Timeline button. The Log Email to Timeline dialog appears.

  3. Select the Don't show this message next time check box, to make logging older emails to Timeline action a one-click operation.

  4. Click Log. The email is logged to the recipient's Timeline activity.


If the resolution of Company or Relationship fails, then follow below steps:

  • If the resolution is not successful, the Log to Timeline dialog appears for the users to resolve the conflicts manually by selecting the Timeline for the Company/Relationship to which the email must be logged.


  • If the user does not resolve or directly sends the email, the email is saved in the drafts section of the Timeline. Users have to log that email manually by logging into the Gainsight application. 

Users can check the status of the log to Timeline from their Gmail Account Sent Items. The following are the statuses users can find for their emails:


Log Emails with Attachments

The attachments in the email are also logged to the Timeline. If the attachment size is larger than 30 MB, then the Google drive link is embedded in the email body. Users can access this link from the Timeline. Based on the permissions set on the file, users may have to request access.

The following are the attachment file types that are supported: jpg, jpeg, gif, png, bmp, pdf, doc, docx, txt, ppt, pptx, xls, xlsx, and csv.

The number of emails and the attachment size limits in the email to be synced is based on the Timeline Activities limits. For more information, refer to the Log Customer Emails as Timeline Activities article. If the size and number of attachments synced are higher than the permissible limits, the system automatically selects the random attachments as per the limits. An email notification is sent to the concerned user about the number of attachments skipped, but not the exact names of attachments.


When logging emails to Timeline, a dialog box appears if there is an issue with the attachment. Users can select any of the following options to proceed:

  • Yes, log to timeline: Log the timeline activity without the attachment.
  • No, I will manually log to timeline: Manually add the attachment on the Timeline page.

Note: To add the attachment manually, navigate to the Timeline page.

An email is open in Gmail with a pop-up message from Gainsight displaying an attachment issue. The pop-up gives two options: "Yes, log to timeline" and "No, I will manually log to timeline

Undo Emails

Based on the user settings (5 to 30 seconds) defined in their Gmail account, emails can be recalled after they are sent. If the email with Log to Timeline option selected is recalled from Gmail within the user setting limits, the email can be recalled successfully but the activity will still be logged to Timeline. However, users have to delete the saved logs manually from the Timeline. 

For more information on the most frequently asked questions on the Gainsight Assist Chrome Plug-in, refer to the Gainsight Assist Chrome Plug-in FAQs article.


The following are the Gainsight Assist Chrome Plug-in limitations when it is used simultaneously with other chrome extensions for Gmail:

  • When the Gainsight Assist Chrome Plug-in is used along with the Mixmax chrome extension, the email does not get logged to the Timeline when the Log to Timeline option is selected while sending emails from the compose mode. As a workaround, users must go to Sent Emails and log the email to Timeline.
  • The Gainsight Assist Chrome Plug-in does not work as expected when it is used along with the Salesloft chrome extension.
  • Was this article helpful?