Recommend Salesforce Knowledge Articles

Offer users quick access to pertinent articles even before they initiate a search. Utilize the “Search.suggest(searchText, objectType, options)” method to provide a roster of Salesforce Knowledge articles whose titles correspond to a user’s search query.

To enable the display of suggestions, make sure Salesforce Knowledge is enabled. For detailed setup instructions, consult the Salesforce Knowledge Implementation Guide.

This Visualforce page incorporates an input field for searching articles or accounts. When the user clicks the “Suggest” button, suggested records are presented. If there are more than five results, the “More results” button becomes visible. To view additional results, simply click the button.

<apex:page controller="SuggestionDemoController">
    <apex:form >
        <apex:pageBlock mode="edit" id="block">
            <h1>Article and Record Suggestions</h1>
            <apex:pageBlockSection >
                <apex:pageBlockSectionItem >
                    <apex:outputPanel >
                        <apex:panelGroup >
                            <apex:selectList value="{!objectType}" size="1">
                                <apex:selectOption itemLabel="Account" itemValue="Account" />
                                <apex:selectOption itemLabel="Article" itemValue="KnowledgeArticleVersion" />
                                <apex:actionSupport event="onchange" rerender="block"/>
                        <apex:panelGroup >
                            <apex:inputHidden id="nbResult" value="{!nbResult}" />
                            <apex:outputLabel for="searchText">Search Text</apex:outputLabel>
                            <apex:inputText id="searchText" value="{!searchText}"/>
                            <apex:commandButton id="suggestButton" value="Suggest" action="{!doSuggest}" 
                            <apex:commandButton id="suggestMoreButton" value="More results..." action="{!doSuggestMore}" 
                                                rerender="block" style="{!IF(hasMoreResults, '', 'display: none;')}"/>
            <apex:pageBlockSection title="Results" id="results" columns="1" rendered="{!results.size>0}">
                <apex:dataList value="{!results}" var="w" type="1">
                    Id: {!w.SObject['Id']}
                    <br />
                    <apex:panelGroup rendered="{!objectType=='KnowledgeArticleVersion'}">
                        Title: {!w.SObject['Title']}
                    <apex:panelGroup rendered="{!objectType!='KnowledgeArticleVersion'}">
                        Name: {!w.SObject['Name']}
                    <hr />
            <apex:pageBlockSection id="noresults" rendered="{!results.size==0}">
                No results
            <apex:pageBlockSection rendered="{!LEN(searchText)>0}">
                Search text: {!searchText}

The provided code serves as the custom Visualforce controller for this page:

public class SuggestionDemoController {
    public String searchText;
    public String language = 'en_US';
    public String objectType = 'Account';
    public Integer nbResult = 5;
    public Transient Search.SuggestionResults suggestionResults;

    public String getSearchText() {
        return searchText;

    public void setSearchText(String s) {
        searchText = s;
    public Integer getNbResult() {
        return nbResult;

    public void setNbResult(Integer n) {
        nbResult = n;
    public String getLanguage() {
        return language;
    public void setLanguage(String language) {
        this.language = language;
    public String getObjectType() {
        return objectType;
    public void setObjectType(String objectType) {
        this.objectType = objectType;

    public List<Search.SuggestionResult> getResults() {
        if (suggestionResults == null) {
            return new List<Search.SuggestionResult>();
        return suggestionResults.getSuggestionResults();
    public Boolean getHasMoreResults() {
        if (suggestionResults == null) {
            return false;
        return suggestionResults.hasMoreResults();
    public PageReference doSuggest() {
        nbResult = 5;
        return null;
    public PageReference doSuggestMore() {
        nbResult += 5;
        return null;
    private void suggestAccounts() {
        Search.SuggestionOption options = new Search.SuggestionOption();
        Search.KnowledgeSuggestionFilter filters = new Search.KnowledgeSuggestionFilter();
        if (objectType=='KnowledgeArticleVersion') {
        suggestionResults = Search.suggest(searchText, objectType, options);