---
schema_version: "1"
id: 263343755944154f2fb5b346f92d703e446b3fba52be6cbddc51eeab8cefed03
title: Promote Articles in Search Results
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/promoted_search_terms.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.promoted_search_terms.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 7ee6b3c2936968866e52046cab9215250a1a8246f15f65a4328d23aecca517b3
description: Associate keywords with knowledge articles to optimize search results in Salesforce Knowledge. Users who search for these keywords by pressing Enter (Windows) or Return (Mac) see the article appear first in their search results.
products:
  - Service Cloud
release: "264"
---
# Promote Articles in Search Results

Associate keywords with knowledge articles to optimize search results in Salesforce Knowledge. Users who search for these keywords by pressing **Enter** (Windows) or **Return** (Mac) see the article appear first in their search results.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in Salesforce Classic and Lightning Experience. <a href="https://help.salesforce.com/s/articleView?id=service.service_editions_reference.htm&amp;language=en_US" target="_blank">View supported editions</a>.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d156922e64">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d156922e64 ">To create, edit, and delete promoted search terms:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d156922e64 ">Manage Promoted Search Terms</td>

          </tr>
        </tbody>
      </table>

Promoted search terms are useful for highlighting an article that you know is commonly used to resolve a support issue when a user’s search contains certain keywords. An article must be published for you to manage its promoted terms.

1. To change the promoted search terms, open the published article.
2. In the Promoted Search Terms related list, click **New** or **New Promoted Term**.
3. Enter the keywords that you want to associate with the article.
    
    - You can associate the same term with multiple articles. If the user’s search matches the promoted term, all associated articles are promoted in search results, ordered by relevancy.
    - The maximum number of characters per promoted term is 100. For best results matching users’ search terms, limit each promoted term to a few keywords.
4. Click **Save**.

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support-264-0-0-production-enus/dd14551c-a772-4db6-9a1d-d84df8df2980/images/icon_example.png)

Example For example, if an article addresses a common support issue such as login problems, you can associate the terms password and password change. Article search matches a promoted term whenever all keywords within the term occur within the user’s search terms, in any sequence. Each keyword must match exactly. For example:

- The promoted term _password_ matches a search for change password.
- The promoted term _password change_ matches a search for how do I change my password but doesn’t match forgot password.
- The promoted term _password_ doesn’t match a search for change passwords.

Consider these limitations and general limits when you use promoted search terms.

- Your organization can create a maximum of 2,000 promoted terms. For best results, use them selectively, create a limited number of promoted terms and a limited number of promoted articles per term.
- If your organization translates articles into multiple languages, each promoted term is associated with one article version and the article version’s language. If you need equivalent promoted terms to be associated with each translation, you must specify promoted terms for each translation. For example, associate change password with an English language article version and changer mot de passe with a French language article version.
- The end user’s language setting determines the scope of the article search. Search results exclude article versions and any associated promoted terms that aren’t in the user’s language.
- When a user performs a Knowledge search, the search engine retrieves all the articles with at least one promoted search term that matches the user's terms. Then it places those articles at the top of the search result list.
- When a user searches for Chinese, Japanese, Korean, and Thai (CJKT) terms, search results can be inaccurate. Simplify the term in Promoted Search, or create an additional field on the article and add the term.

#### See Also

- [Article Search Results](https://help.salesforce.com/s/articleView?id=service.knowledge_search_algorithm.htm&release=264.0.0&type=5 "How search works for knowledge articles depends on your use of search options, search terms, wildcards, and operators. Salesforce Knowledge search uses the same custom search algorithms that are available throughout Salesforce, which include mechanisms such as tokenization, lemmatization, and stopword lists, to return relevant search results.")
- [Search Articles and External Sources on the Knowledge Tab](https://help.salesforce.com/s/articleView?id=service.knowledge_tab_search.htm&release=264.0.0&type=5 "Use a single search to find all your resources at once.")
- [Salesforce Knowledge Help and Resources](https://help.salesforce.com/s/articleView?id=service.knowledge_map.htm&release=264.0.0&type=5 "Find the information you need about Salesforce Knowledge. Explore help documentation, developer documentation, and Trailhead modules.")