Word mapping

Define and edit mappings that redirect a search term directly to a page in the store.

Word mapping screen allows you to redirect a search term directly to a page in the store. For example, if you want the customer to go to the men's boots page instead of search results when they type "bot" in the search box, you define a mapping for this term. The e-commerce team that wants to link campaign pages, frequently searched categories, or terms that yield no results to the correct page uses this screen. You manage the mappings you define manually on this screen.

Accessing the screen

Follow the menu path Searchandising › Rules › Word mapping.

If you do not see it in the menu, your account does not have permission for this screen. If you can see the list but the New mapping button and the edit pencil icons in the rows are not visible, your account has view-only permission on this screen.

Screen sections

  1. Title — The Word mapping title and (if you have write permission) the New mapping button on the right.
  2. Summary cards — Total mappings and Distinct sites.
  3. Filter area — Search word and Site id fields; Clear and Filter buttons.
  4. List — Per page selection, "Filter result: … records" count, refresh button, Columns menu, table, and pagination.
  5. Note — Under the list, the note "There is no deletion in this list: records are only added and updated.".

Summary cards

Card Meaning
Total mappings Number of mappings matching the applied filters (not only on this page but across all pages).
Distinct sites Number of distinct site IDs present in the records. Selecting in the Site id filter does not change this number.

Filtering and searching

Entries in the filter fields are applied when you press the Filter button or Enter while in the field; the list reloads from the first page. If there are unapplied changes, the Filter button appears highlighted.

Field Purpose Tip
Search word Performs text search within records. Type part of the term you are looking for.
Site id Narrows the list to mappings belonging to a single site. If records have sites, the field appears as a dropdown list; selecting All removes the filter. If no records have sites or the list is not yet loaded, the field is a text box.

Clear empties all filters and immediately reloads the list. Filters and sorting are stored in the page URL; you can share the filtered list link.

List

Column Meaning
Term The term the customer typed in the search box. This column cannot be hidden.
Routing The in-store address to go to when the term is searched (e.g., /men-boots).
Site id The site to which the mapping belongs. Since it is selected from the company list in the record window, the company name appears here. If empty, "—" is shown.
  • Sorting: All three columns are sortable; click the header. Changing sorting returns to the first page.
  • Page size: 25, 50, or 100. Default is 25.
  • Hide columns: You can hide Routing and Site id columns from the Columns menu. The selection is remembered in this browser.
  • Refresh: The refresh button in the top bar reloads the list without changing filters.
  • Clicking a row does not open a page; editing is done via the pencil icon on the right of the row.

Actions

Adding a new mapping

  1. Click the New mapping button at the top right.
  2. Enter the term the customer types in the search box in the Search term field (e.g., bot).
  3. Enter the relative store address of the page to go to in the Redirect URL field (e.g., women-shoes or /men-boots).
  4. If necessary, select the company from the Site (company) list.
  5. Click Save (or press Enter while in a text field).

If the record is successful, a "Saved" notification appears, the window closes, and the list and cards refresh. There is no confirmation before saving.

The screen does not validate the format of the redirect URL or whether it actually exists in the store; it only requires that it is not empty. Before saving, open the address in the store to verify it leads to the correct page.

Editing a mapping

  1. Click the pencil icon (Edit) on the right of the row.
  2. The window opens with the title "Edit mapping: <term>" and the current values of the record.
  3. Change the term, redirect URL, or site and click Save.

The record updates immediately and the list refreshes. Cancel or Close closes the window without applying changes. If the site in the record is not found in the company list, it remains selected as the current value; unless you change the site, the mapping stays on the same site.

If you select Select… in the Site (company) field and save, the mapping is saved without site information.

Deletion

There is no deletion on this screen. Mappings are only added and updated. To correct a wrong mapping, edit it to redirect to the correct address.

Record window fields

Field Required Description / rule
Search term Yes The term the customer types in the search box. If empty, the warning "This field is required." appears. Leading and trailing spaces are not saved.
Redirect URL Yes The relative address in the store, e.g., women-shoes. If empty, the warning "This field is required." appears. Leading and trailing spaces are not saved.
Site (company) No List of company names; loaded when the window opens. The selected company name is saved as the site ID of the mapping. If no selection is made, it remains as Select….

If any required field is empty, Save is disabled and pressing Enter does not save. When saving, the button shows "Saving…".

Common situations

  • For which terms should I define mappings? Check the share of Unmatched searches on the Overview dashboard and examine frequently searched or no-result terms on the Search logs screen.
  • I don't see the New mapping button. Your account has view-only permission on this screen; contact your administrator for write permission.
  • Save button is disabled. The Search term or Redirect URL is empty.
  • No options in the Site (company) list. The company list loads when the window opens; wait a moment. If the list fails to load, no additional warning is shown; saving without selecting a site saves the mapping without site information.
  • Received "Something went wrong" notification when saving. The record was not saved; the window and your entered values remain open. Check the notification details and try again.
  • I want to delete a wrong mapping. There is no deletion on this screen; edit the mapping to redirect to the correct address.

Related screens

  • Overview — Monitor how many searches are linked to redirects.
  • Search logs — Number of searches per term and redirect status.
  • Synonyms — Link alternative spellings to the correct word.
  • Search settings — Automatic category redirection settings for terms.