Result Mappings

Result mappings grant you extensive control over the search behavior in response to specific search queries entered by your site visitors. It allows you to customize and display desired results for specific queries.This article explains how to set them up.

Let's start by opening your Site Search 360 control panel and going to the Result Manager -> Result Mappings section:

set up custom results for search queries
  1. Click on "+ Add New Result Mapping" and fill in the search term(s) for which this results mapping should be applied. Type any word or expression into the "Trigger" field:

    adding query terms as triggers

    Note that multiple triggers can be added by repeatedly clicking on "+ Add trigger".

  2. Every time you create a mapping, you have to choose the Matching Type. This defines how your visitor's query compares to your mapped query:

    1. Matches: The visitor's search query has to be a perfect match for the mapping to apply.

      If you enter "fish" as the trigger in step 2 and select the type "matches", then the mapping will only be triggered when the visitor's query contains the word "fish" and nothing else.

    2. Contains part of word: The mapping will be applied if the visitor's search query contains the trigger.

      In this case, the specified results will be shown for all search queries that contain "fish", including "fishing", "fishermen", but also "selfish".

    3. Contains entire word: The mapping will be applied if the visitor types in several search terms and the entire mapped query is among these terms (part of the search phrase).

      Taking the same "fish" query example, "fish and chips" or "fresh fish" will bring up the results that you specify for "fish" in this case.

    4. Matches a regex: You can come up with advanced matching rules if you are fluent in regular expressions. So, your trigger could be something like:

      ^(fish hook|fishhook|catching fish)$

      You can learn more about regular expressions here.

  3. Now, select what should happen when the specified queries are triggered:

    There are three options available, which will be described in the following sections:

Customize Results

  1. Here you see the list of result groups available for the entered query.

  2. You can drag and drop the results freely to rearrange them.

    By dragging and dropping a search result, you may choose a new position for it in the list of naturally ranked search results.

  3. You can remove an unwanted result from the result list by clicking the "👁", which hides it.

  4. Any result can be pinned to fix its position. You can pin multiple results one by one.

  5. You can restrict the search results to only show the pinned results with the toggle in the top right. Setting the toggle to "ON" will remove all other results and show just the pinned results to the user.

  6. Use "+" -> "Create new custom result" to create a featured search result or a promotional banner.

    Our Custom result editor allows you to easily fill in the necessary elements to create a result:

    • Result name (to look it up internally)

    • Title

    • Image URL (optional)

    • Result link

    • Result content (search snippet)

    Results created with the editor shown above will perfectly blend in with the rest of your results as the same styling is applied to them by default.

    If, instead, you're looking to create a promotional banner that stands out, select the "HTML" option. This option gives you complete freedom to customize the markup and styling of your banner.

    You can additionally provide the suggestion HTML if you want the banner to come up in your search suggestions as well (as-you-type results shown in the dropdown below the search box).

Note: your custom results can be dragged around and placed in a certain position just like natural search results. A custom result is always pinned, i.e. its position - first, second, fourth in the list, etc. wouldn't change.

Rewrite trigger to

When a certain query already triggers correct search result rankings and you'd like a similar query or a synonym bring up the same exact results, e.g. you have a product called "Travelr" and you want to display the same results for "Traveler", you can rewrite Traveler to Travelr.

Redirect to URL

You can redirect queries to a specific page when you want certain keywords to directly open a dedicated landing or a promo page or save your customers some clicks by redirecting, for example, contact or email queries to your contact page.

Note: Result Mappings (unlike the Dictionary entries) DO NOT require a re-index, they are applied on the go. You can test them immediately after saving by typing in the mapped keyword into the Search Preview in your Control Panel.

Custom result HTML templates

The following templates match the default styling and structure of the search results rendered with our v13 script.

Make sure to replace the {LINK}, {TITLE}, {TEXT}, and {IMAGE_URL} placeholders with the respective content.

Tip: if you want your custom results to perfectly match the styling of the rest of your results, it's easier to use our Custom result editor instead of editing the HTML snippets.

Adding a custom result without an image:

<div class="ss360-suggests__content">
    <header class="ss360-n-section ss360-suggests__header">
        <span role="heading" class="ss360-suggests__link-wrap" aria-level="4">
            <a class="ss360-suggests__link ss360-ac-c" href="{LINK}" target="_blank">{TITLE}</a>
        </span>
    </header>
    <p class="ss360-suggests__snippet">{TEXT}</p>
</div>

Adding a custom result with an image:

<div class="ss360-suggest__image-container">
<a class="ss360-suggests__image-wrap" aria-hidden="true" tabindex="-1" href="LINK">
    <img alt="" aria-hidden="true" role="presentation" aria-label="{TITLE}" class="ss360-suggests__image" src="{IMAGE_URL}">
</a>
</div>
<div class="ss360-suggests__content">
    <header class="ss360-n-section ss360-suggests__header">
        <span role="heading" class="ss360-suggests__link-wrap" aria-level="4">
            <a class="ss360-suggests__link ss360-ac-c" href="{LINK}" target="_blank">{TITLE}</a>
        </span>
    </header>
    <p class="ss360-suggests__snippet">{TEXT}</p>
</div>

Adding a custom search suggestion without an image:

<a class="unibox__search-content unibox__search-content--link" href="{LINK}" title="{TITLE}">{TITLE}</a>

Adding a custom search suggestion with an image:

<div style="display:flex;">
    <img src="{IMAGE_URL}" width="{IMAGE_WIDTH}" height="{IMAGE_HEIGHT}" style="margin-right:16px;">
    <a class="unibox__search-content unibox__search-content--link" href="{LINK}" title="{TITLE}">{TITLE}</a>
</div>