Skip to main content

Install GeniusLink in Salesforce Sales Cloud

This page applies to:MindTouch Responsive

This document explains how to integrate MindTouch GeniusLink in your Salesforce Sales Cloud.


Prerequisites & important notes:

  • The Salesforce Base Package must be installed. 
  • Users who want to publish using this integration must be pro members.
  • Your Salesforce admin needs to install this integration in Salesforce.
  • Your Salesforce org has to have Sales Cloud enabled.
  • Your MindTouch site will need to be configured with an SSL.

Set up Salesforce Sales Cloud

  1. Install the package MindTouch GeniusLink for Sales Cloud. Select the users to grant access to and click Install to proceed.
  2. Follow the step Add GeniusLink to Sales Cloud Opportunities. (You have already configured the previous steps.)
  3. On the Package Installation Details page, click Continue.

package install details.png


  1. In the Package Installer, on Step 1, review and approve the object permissions needed to use this widget and click Next.


  1. On Step 2, select Grant access to admins only and click Next.

  NOTE:  For the purpose of this demo, we will make the widget  available to Salesforce admins only.


  1. On Step 3, click Install to install the package.


  1. Upon successful installation, the Package Details page displays a message informing of the completed installation.

installation success.png

Edit GeniusLink settings

Once you have successfully installed your MindTouch GeniusLink widget, you need to set up the integration settings:

  1. Click your name in the upper right.
  2. Select Setup.
  3. Under App Setup, select DevelopCustom Settings.


  1. In Custom Settings, select Manage next to MindTouch Settings.

manage custom settings.png

  1. On the MindTouch Settings page, click New at the top of the dialog to create a new default organization level value.

new custom setting.png

  1. In the MindTouch Settings Edit dialog edit your settings.
Field Meaning
Location Case Search Field The field to conduct the search on. Leave this at Subject.
Site Name The name of your MindTouch site. This will be displayed at the top of the widget.
MindTouch URL The URL of your MindTouch site.
Publish Article Path The path in your MindTouch site where created articles will post to.
Customer Activity ID Field This is the API name of the custom field within a case you have created to store the MindTouch customer activity ID. Example: customer_activity_id__c

edit custom settings.png

  1. Click Save.
  2. Once you have successfully saved the settings, you will be redirected to the MindTouch Settings Detail screen.

Add your site to approved remote sites

In order to take full advantage of GeniusLink you need to add your MindTouch site as an approved site in Salesforce.

  NOTE:  If you skip this step, you can still use GeniusLink Search, but you cannot relate articles to cases. 

  1. In the Setup dialog, under Administration Setup, select Security ControlsRemote Site Settings.


  1. In the All Remote Sites dialog, click New Remote Site and enter the corresponding values:
Field Description
Remote Site Name Name of your MindTouch site (no spaces).
Remote Site URL The (https) URL of your MindTouch site.
MindTouch URL The (https) URL of your MindTouch site.
Disable Protocol Security Disable site protocol security. (This may have security implications if value is disabled). Leave unchecked.
Description Description of the remote site (optional).
Active Check to make remote site connection active.




  1. Click Save.
  2. You should be able to access your GeniusLink application with full functionalities. 

Add Related Articles to the Case Page Layout

Once you have successfully installed the GeniusLink widget and configured the custom MindTouch settings, you can now add the Related Articles object by customizing the case view:

  1. In the Setup menu, under App Setup, select Customize > Cases > Page Layouts.
  2. Under Case Page Layouts, select Edit next to Case Feed Layout.

case page layout.png

  1. In the Case Layout Editor tools, select Related Lists and find MindTouch Related Articles.

mindtouch related articles.png

  1. Click and drag the MindTouch Related Articles list to any place on the layout panel, preferably under Related List. 

mindtouch related article drag and drop.png

  1. Click the wrench icon to edit the properties.
  2. In the Related List Properties - MindTouch Related Articles dialog, add the fields you want to display in the Related Articles list. Once you are satisfied with the fields, click OK.


  1. Click Save in the Case Layout Editor tools​.
  2. Navigate to Cases in your Sales Cloud console and verify the MindTouch Related Articles list.

related article list.png

Add GeniusLink to SalesCloud Opportunities

Once you have successfully installed the GeniusLink widget and have configured the custom MindTouch settings, you can now add the GeniusLink widget to your Sales Cloud screen:

  1. On the Setup menu, under App Setup, select CustomizeOpportunities > Page Layouts.


  1. Under Opportunity Page Layouts, select Edit next to Opportunity Layout.


  1. In the Opportunity Layout dialog, from the Fields section, select and drag Section to an area within the opportunity details.


  1. In the Section Properties dialog, enter the following details:
Field Value
Section Name MindTouch
Display Section Header On Detail Page, Edit Page
Layout 2-Column
Tab-key Order Left-Right



  1. Click OK to save the new section.
  2. To confirm the section was added successfully, look for it under Opportunity Detail.

MindTouch section.png


Add a search component to Opportunities

After you have successfully added a new section, add the search component: 

  1. Select Visualforce Pages in the components section.
  2. Drag and drop the mindtouch_search_opportunities to the newly created MindTouch section.

mt search for opp.png

  1. Click the wrench icon to configure the Visualforce Pages.

opp drag.png

  1. In the Visualforce Page Properties dialog, enter the following values:
Field Value
Width 100%
Height 400 (400 pixels in the minimum recommended height)
Show scrollbars leave unchecked
Show label leave unchecked



  1. Click Save to save your changes and view the newly installed integration.