Skip to main content
Gainsight Inc.

Setup a Gainsight Domain

Gainsight NXT
Gainsight helps innovative companies protect and nurture their most valuable asset - their customers - with the power of our award-winning platform. With our Customer Success Solution, you can gain deeper insights into customer behavior, operationalize the customer lifecycle, and coordinate actions and results across teams.

This article supports Gainsight NXT, the next evolution of the Customer Success platform. New and upgraded customers are deployed on Gainsight NXT.

If you have not upgraded and are using Gainsight Salesforce Edition, you can find supporting documentation here.

Not sure what your team is using? Click here.

 

Introduction

This article talks about how to create and configure a domain, site, and pages for rendering surveys. The primary domain in Gainsight is gainsightcloud.com; you can create a sub-domain on this primary domain. For example, if a sub-domain name is customerfeedback then the sub-domain appears as customerfeedback.gainsightcloud.com.

If you have an existing domain within your organization, you can create a custom domain within Gainsight, and map with your existing domain. For example, if your existing domain is yourcompanyname.com, and the custom domain name is customerfeedback, then the custom domain appears as customerfeedback.yourcompanyname.com.

To setup a domain for your business requirement, you can select a sub-domain or custom domain. You will need to setup a domain to publish surveys by creating the following:

  1. Sub-domain or Custom domain
  2. Pages
  3. Sites

Important

  • Types:
    • SUB_DOMAIN: Domain created by Customer within Gainsight
    • CUSTOM_DOMAIN: Domain provided by Customer
  • Primary Domains: gainsightcloud.com
  • Pre-registered Sub-domains: gainsight, gong, gs, gainsight-qa, gainsight-test, gainsight-preprod, gainsightapp, gainsight-dev

Prerequisites

  • Certificate Key, Certificate Body and Certificate Chain are required for creating custom domains.
    Note: Contact your Network Administrator to obtain these certificate details.

Key Terms

  • Sub-domain: The primary domain for Gainsight is gainsightcloud.com, the sub-domains can be created and configured on the primary domain.
  • Sub-domains are created within Gainsight. The sub-domain name appears in all tenant URLs and uses the instance name of Gainsight. For example, you can brand your URL by naming the sub-domain with your company name.  
    Sample Sub-domain: https://myCompanyName.gainsightcloud.com/ (not for use).
  • Custom domain: The custom domains can be created and customized irrespective of the Gainsight primary domain. The custom domain name appears in all org URLs and replaces the instance name of Gainsight.
    For example, you can brand your URL by naming the custom domain with your company name.
    Sample Custom Domain: https://myCompanyName.com/ (not for use)
    Note: Domains contain the list of configured sub-domains and custom domains in the organization. You have the ability to edit and delete domains except for domains that are already used in a site.
  • Pages: Pages are used to create custom HTML content and these pages can be used in Sites.
  • Sites: Sites uses the domains and pages for distributing surveys.

Limitations

  • Once a sub-domain is available and saved by the user, the user cannot modify the sub-domain further.
  • You may create up to five sub-domains and one custom domain per tenant.

Rendering Surveys using Sub-domain

To get started, create the following:

  1. Sub-domain
  2. Pages
  3. Sites
  4. Publish

1. Surveys.png

Create a Sub-domain

To set up a sub-domain, choose a unique sub-domain name and register it with Gainsight domain registries. You can try out names and check availability before registering it. Choose your name carefully. When you register, Gainsight updates its domain registries with your sub-domain. After the sub-domain name is verified and saved, Gainsight Customer Support can only disable or change your sub-domain name.

2. Domain new.png

To create a sub-domain:

  1. Navigate to Administration > General > Domains.
  2. Click + to create a new sub-domain.

3. To create.png

  1. Enter the following details:
    1. Name: Domain Name
    2. Description:  Domain Description
    3. Map your existing domain: Do not enable this, as the sub-domains are created within Gainsight.
    4. Configure your Gainsight Domain: The customized sub-domain name (maximum of 15 characters ).
  2. Click Check Availability to confirm if the selected sub-domain name is available for use.
  3. Click ✓ at the bottom-right of the page to save the question and its configuration. 

4. new domain creation.gif

  1. Wait for some time and refresh the page. You will see the sub-domain is verified automatically.
    Notes:
  • The domain verification is required to ensure that the domain is valid and you have sufficient privileges over the domain.  
  • The maximum waiting time for the verification of sub-domain is 2 to 3 hours.
  1. Contact support@gainsight.com if the sub-domain remains Unverified.

Create Pages

Page is an individual HTML content created for your business need and configured with a site. Here, you can edit the HTML contents to create a survey form.

Notes: 

  • You must create a page to host your survey in order to distribute it successfully.
  • (Optional) You can also use select Pages as custom Thank You messages for your survey. Custom Thank You messages are not required to distribute your survey. For information on using Pages for Thank You messages, refer to Survey 2.0 Properties.

To create a page:

  1. Navigate to Administration > General > Pages.
  2. Click + to create a new page.

5. New domain.png

  1. Enter the following details:
  • Name: Page Name
  • Note: Ensure that the characters you enter are alphanumeric.
  • Description: Page Description
  • Page Content: You have the ability to create or insert the html content and use it in Sites.
    Note: You may see an error message, if there are any errors in the HTML.
  1. Click  at the bottom-right of the page to save the question and its configuration.

new page creation .gif

Create Sites

Site is a collection of HTML pages created for your business requirement and located under a single domain name. Here, the site URL is used for rendering Surveys.

To create a site:

  1. Navigate to Administration > General > Sites.
  2. Click + to create a new site.

7. Create a new site.png

  1. Enter the following details in the Sites Management page:
  • Name: Site Name
  • Description: Site Description
  • Authentication Required: Check this to require authentication for the site.
  • Select Domain: Select a domain from the available list.
    Note: You can see only the valid and verified domains in the dropdown list.
  • Path: Choose the path for your site configuration. For the combination of domain and path, validate the path to check if it is unique, otherwise you will not be able to save the site.
  • Default Page: Select the default page from the dropdown list. The default page is the page you enter when you click the path.
  • Inactive Page: Select the in-active page from the dropdown list. Select the pages as in-active, when the sites are down or under maintenance or in case of any error.
    Note: To configure a site, you should at least select the Default and In-active pages.
  • Associated Pages: You have the ability to select multiple pages from the dropdown list to be associated with a site.
    Note: Default, In-active and Associated pages should be mutually exclusive.
  • Active: Select the Active checkbox to activate the site.  This site can now be used in the Survey module.
  1. Click  at the bottom-right of the page to save the question and its configuration.

8. new site creation.gif

  1. Copy and paste the site URL in a new tab to preview the survey page.
    Note: By default, Gainsight standard HTML is inserted in the header and footer so that you can modify the content and use it for the page configuration.

9. copy site url.gif

  1. Once the site is saved, you can select the relevant site URL from the dropdown list, on the survey distribution tab. For more information, refer to Distribute Surveys.

Publish

To publish Surveys, refer to Distribute Surveys.

Rendering Surveys using Custom Domain

To get started, create the following:

  1. Sub-domain
  2. Pages
  3. Sites
  4. Publish

10. rendering.png

Create a Custom Domain

To set up a Custom domain, choose a unique custom domain name and register it with Gainsight domain registries. You can try out names and check availability before registering it. Choose your name carefully. When you register, Gainsight updates its domain registries with your custom domain. After the custom domain name is verified and saved, only Gainsight Customer Support can disable or change your custom domain name.

setup.png

To create a custom domain:

  1. Navigate to Administration > General > Domains.
  2. Click + to create a new custom domain.

12. Domain.png

  1. Enter the following details:
  • Name: Custom Domain Name
  • Description:  Domain Description
  • Map your existing domain: Enable this to map and configure the existing domain.
  • Configure your Gainsight Domain: The custom domain name
    Note: Ensure that the number of characters in the domain name are less than 15.
  1. Click Check Availability to confirm if the selected domain is available for use.
  2. Before setting up a custom domain name, you must obtain the certificate key, certificate body and certificate chain, these details are required to establish a secure connection between a web server and browser. The certificate key, certificate body, and certificate chain must be Privacy Enhanced Mail (PEM)–encoded.

Enter the following details:

  • Certificate Key: Copy and enter the certificate key. The following image shows an example of a certificate key.
  • What is a Certificate Key: These keys are simply numbers (128 bit being common) that are combined with the message using a particular method, commonly known as an algorithm, e.g. RSA, to either encrypt or sign the message. Almost all encryption methods employ public and private keys. The public key is placed in the certificate or request. The associated private key is kept secret. You will specify the private key when you import the certificate. The key must be unencrypted. The following example shows an RSA private key.

13. Copy.png

  • Certificate Body: Copy and enter the body of the certificate from your certificate authority. The following image shows an example of a certificate body.

14. Certificate.png

  • Certificate Chain: Copy and enter the certificate chain.
  • What is a Certificate Chain: The certificate issued for your domain constitutes the certificates chain with a CA bundle. A certificate chain contains one or more certificates. You can use a text editor, the copy command in Windows, or the Linux cat command to concatenate your certificate files into a chain. The certificates must be concatenated in order so that each directly certifies the one preceding. Copy the root CA certificate last. The following examples contain one and three certificates respectively. Your certificate chain may contain one or more certificates.

15. certificate chain 1.png

16. certificate chain 2.png

Notes:

  • Do not copy the certificate body into the certificate chain.
  • If you edit any of the characters or if you add one or more spaces to the end of any line, the certificate body, certificate chain, or certificate key will be invalid.
  1. Click  at the bottom-right of the page to save the question and its configuration.
  2. By default, the custom domain remains unverified.
  3. Click on the custom domain created, you will see a CNAME generated.

17. new create custom domain.gif

Note: Certificate key, body and chain are sensitive information, you will not be able to see these details once it is configured and saved. In case, if you want to modify the certificate details, click Modify Certificate to enter the new details for certificate key, body and chain. This will override the previous entries configured.

18. CNAME.gif

  1. Copy the CNAME link and configure the settings with the DNS provider so that whenever the custom domain URL is clicked, it will redirect to the CNAME.
    Note: This configuration may require your Network Administrator Support.
  2. On the Domain Configuration page, hover to the Options and verify the domain to confirm that the CNAME is configured correctly.

19. verify domain.gif

  1. After the verification is done, the custom domain is available for use in Sites.

Create Pages

To create pages, refer to Create Pages.

Create Sites

To create a site, refer to Create Sites.

Publish

To publish Surveys, refer to Distribute Surveys.

  • Was this article helpful?