General Overview

Customize your search experience using contextual data to present “Smart Suggestions” to your users before search is even needed, cutting down on the time it takes them to find the help they’re looking for. 

Contextual data is then passed into your search widget through URL parameters.

Widget Setup with Smart Suggestions

• Smart Suggestions is set up in your individual Knowledge Search Widgets.
  
  
• Expand the Smart Suggestions panel on your search widget to control what data can prompt a pre-search.
• Configure your search to listen for certain variables that can inform the pre-search and present suggestions to your users on launch, prior to an active search
• Add up to 10 variables

How to add parameters to the URL for your search

You can pass the NAME of the variable and the corresponding VALUE as a PARAMETER  into the URL hosting for deploying your search.

• To add a parameter to your search via the URL, you can simply append a question mark (?) followed by the variable name, an equal sign (=) , and the value. Like this: 
   

  zingtree.com?NAME=VALUE

• If you have multiple parameters to pass along, separate them using an ampersand (&), like this: 

  zingtree.com?NAME=VALUE&NAME=VALUE&NAME=VALUE

• If you have multiple values to pass along for a single variable, add them using comma separated values, like this: 
   

  zingtree.com?NAME=VALUE,VALUE,VALUE

Details relevant to the deployment method you’re using for search:

In-Tree

Append your URL parameters to the URL of the tree hosting your embedded widget. The search widget launched from a tree inherits the URL and parameters from the starting host tree.

Predefined variables can be added to the tree through the tree editor.

Embed

Append your URL parameters to the URL of the page hosting your embedded widget. The search widget launched from an embed inherits the URL and parameters from the host. See details on embedding a search widget. 

To populate dynamic values, you’ll need to map data from the host to the embed code powering the search widget.

Salesforce Integration

Support for this coming soon!

• Predefined variables can be added to your search component inside the Lightning object editor
• In order to map a field correctly from Salesforce into that predefined variable — you first need to grab the correct variable name from Salesforce (Setup>Object Manager)

Standalone

Generating dynamic URL parameters is not available for the standalone search widget, but these can be added manually if needed