CMS 10.6 Adding Synonyms


Website end users may search for content with terms that are similar in meaning to existing terms and phrases. Since their search terms were not exact matches, no search results return, even though content exists that may be of interest to them.

To increase the chances of website end users accessing content relevant to them through search, administrators can create a synonym list. This list may include either of the following synonym types: equivalents (bidirectional) and one way (directional).

Equivalents
Used when there is no need to restrict the relationships among terms. Each term is a synonym of the other terms.
One Way
Used when administrators need to restrict the relationship between the lead term and the other term(s). Only the lead term is related to the other terms; whereas, the opposite is not true.

For example, you can use this one-way synonym configuration to account for searched words that are commonly misspelled. (e.g., buisness > business, where the misspelled term buisness leads to search results for business, but not the other way around.)

Tip
If your organization has already configured synonyms.xml, administrators can import the synonyms.xml file, which is a collection of your customized synonym sets, and then continue to add to or edit the list in the CMS UI.
To configure synonyms for better search results:
  1. Navigate to Administration > InSite Search > Synonyms.
  2. Select Add Synonym in the Custom Synonyms tab.

    Add Synonym Button

    A new row entry displays in the Manage Custom Synonyms list where you will add synonym terms (or phrases).

    New Row Entry in Manage Custom Synonyms List

  3. Select one of the following synonym types for the row entry in the Type drop-down list.
    • Select Equivalents, and follow these steps.
      1. Select the Add Synonym plus (+) icon in the Synonym column row entry.

        An inner Add Synonym field displays.

        Tip
        If you added a row entry that contains no synonym terms or phrases yet, then skip this step. The Add Synonym field automatically displays in empty row entries.

      2. Enter a synonym term or phrase in the Add Synonym field.
      3. Select the Add Synonym plus (+) icon again, or press the Enter key on your keyboard.

        Add Synonym Plus Icon

        Your synonym term or phrase now displays in the Synonym column row entry.

      4. Repeat these steps to continue adding synonyms as needed.

        Equivalents Synonym Type Row Entry with Terms

    • Select One Way, and follow these steps.
      1. Enter a term in the Lead Word field that will lead to search results for other term(s) you will add in the adjacent field but not vice versa.

        Empty Lead Word Field

        Lead Word Field Value

      2. Select the Add Synonym plus (+) icon in the in the Synonym column row entry (located directly to the right of the Lead Word field).

        An inner Add Synonym field displays.

        Tip
        If you added a row entry that, aside from the Lead Word, contains no synonym terms or phrases yet, then skip this step. The Add Synonym field automatically displays in empty row entries.
      3. Enter a synonym term or phrase in the Add Synonym field.
      4. Select the Add Synonym plus (+) icon again, or press the Enter key on your keyboard.

        Add Synonym Plus Icon

        Your synonym term or phrase now displays in the Synonym column row entry.

      5. Repeat these steps to continue associating synonyms with the Lead Word as needed.

        One Way Synonym Type Row Entry with Terms

  4. Optional: Repeat the steps above to create additional synonym row sets as necessary.
    Note
    To remove a synonym term or phrase, select the delete (X) icon next to the synonym entry. To delete an entire row entry within the Manage Custom Synonyms list, select the Delete (trash) icon Delete Icon associated with the row.
  5. Select Save.
    Tip
    After the initial configuration of synonyms, your list of customized synonym sets may become extensive. If you need to edit a row entry within the list, you can locate terms the by using Find Terms search field in the rightmost corner directly above the list.