# Selecting Suggest Product and Search Data ## Summary The **Suggest import** page lets you specify how and where Suggest obtains its data. **Suggest import** appears as a dedicated tab on the **Suggest** page. > Note: Re-import Suggest data for any changes on this page to take effect. ## Product database In this section you specify the sources used to generate suggestions. Suggestions from selected sources can be assigned to specific groups (suggestion types). *For example: select the type* `Brand` *for the field* `brandName`*, then the Suggest window will display "Brand" after each brand (or manufacturer) name obtained from that field.* [![suggest\_import](/files/QdLx8PFm3K9miv7usazZ)](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040138/1/1659541649583/image2022-8-3_15-47-29.png) ![](/files/Ph63z0daepEWYQihI5Tp) **Active:** if checked, the sources configured below are used in Suggest. ![](/files/Ehk1tMw4qBIWvCgJj7rh) **Prevent zero-hit suggestions:** enable to use search ranking rules and Suggest ranking rules to avoid zero-hit suggestions. Disable to use only Suggest ranking rules. *Example: If this is enabled, no brands are suggested if all of their products have been excluded by ranking rules. If disabled, the brand could still be suggested, but clicking it would result in a zero-hit search because no product was found.* ![](/files/UipZ5ADW4CYdVObCmdDS) **Limit fields used in the product database:** search only the "Product Name" field and fields configured in "Additional Search Data". Otherwise, all searchable fields are used. This can speed up suggestions and prevent, for example, unwanted brand suggestions when the term appears only in the description. ![](/files/2XF0kf1Bm7Z35I6UtFNL) **Product data field:** select a field whose data Suggest should use. ![](/files/cVfuaDKK4FYgURysSN7J) **Type of suggestion:** select the Suggest type. Standard types are `productName`, `brand`, `category` and `searchTerm`. ![](/files/dOZlcoZrhcFshT4JyY3F) **Add source field:** add the selected field and its suggest type to the import. ## Search history Suggest can also use data from the **log files of recent days**. ![](/files/8zeNpPTk8YNrJNBfpAoF) * **Deactivate** this option to remove user-generated search terms from suggestions. * **Minimum score** sets the minimum relevance for suggestions. * **Minimum number of characters** sets the minimum query length before suggestions appear. * **Required filters:** if chosen, only suggestions in which one of these filters has been used are added, and the corresponding `field` + `value` pair is included as an attribute. ## Duplicate removal ![](/files/MElh3RsKusKShfFR2BPR) By default, duplicates of existing products are removed from suggestions. You can disable this by clearing ![](/files/Ph63z0daepEWYQihI5Tp), or limit duplicate removal to within a suggest type using ![](/files/Ehk1tMw4qBIWvCgJj7rh). ## Extended priority determination ![](/files/ZVnkqrjFF2PojBBbg9j9) Normally, suggestions are ordered by FactFinder similarity. If this option is active, the order is determined by frequency of use. ## Hit count and preview image calculation By default, **hit counts and preview images** are calculated based on a ranked search database. ![](/files/fbYXFK9hrlK8xNZmwwph) You can disable this setting. ## Suggest import settings ![](/files/x1RctolhKGA0LZ7NG0ZW) These options directly influence the import: ![](/files/Ph63z0daepEWYQihI5Tp) **Min. amount of records:** minimum number of imported suggestions needed for the import to be considered successful. Note: Product suggestions aren't imported during the suggest import if the setting 'Response with product suggestions from search database' is active. ![](/files/Ehk1tMw4qBIWvCgJj7rh) **Trim Whitespace**: Removes spaces from the beginning and end of the entry, as well as duplicate spaces between terms. ![](/files/UipZ5ADW4CYdVObCmdDS) **Remove HTML code**: Replaces HTML code with a space and decodes the HTML elements. Start and end tags are removed completely, multiple tags are replaced with spaces. ![](/files/2XF0kf1Bm7Z35I6UtFNL) **Replace special characters with ISO counterparts**: All special characters are replaced with ISO characters. ![](/files/cVfuaDKK4FYgURysSN7J) **Deduplicate field values**: Duplicate values are removed from the return data, so they are unique. ![](/files/dOZlcoZrhcFshT4JyY3F) **Deduplicate suggest search content**: Removes duplicates from additional search data fields. ![](/files/afMFqoHYxlD3P4x4s54e) **Import on startup:** Import this channel on system startup. Even if it is activated by default, the setting has no effect and cannot be edited if the global import on startup module is deactivated. ![](/files/heY1jGf0d6KIgQt5tmq5) **Import suggest in product import interval**: By setting this checkbox a Suggest import is conducted along with the product data in its update interval. ## Suggest data manual import Like the search database, the Suggest database is usually updated automatically, making a manual import only necessary for configuration changes. > Calculating result counts and displaying preview images during Suggest import is resource intensive. Avoid doing this during peak activity periods. ![](/files/N1Zlr37Wpl5kKaS2JObO) *** > **1. Go to Import** In the menu bar, go to **Import**. *** > **2. Choose a Channel** Choose a channel from the dropdown menu or select **All Channels**. *** > **3. Select Suggest** From the left-hand dropdown menu, select **Suggest**. *** > **4. Start import** FactFinder re-imports the data based on your Suggest configurations. ## Version 2.0 and earlier How to determine the FactFinder [version](/docs/readme/what-is-factfinder.md) *** > **Product database** [![](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040152/1/1659541645134/2021-04-09+13_53_35-Import+-+FACT-Finder-Management.png)](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040152/1/1659541645134/2021-04-09+13_53_35-Import+-+FACT-Finder-Management.png) | | | | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | **Use ranked search database** ![](/files/Ph63z0daepEWYQihI5Tp) | If enabled, ranking rules will be taken into account in the suggest. | | **Product data field** ![](/files/Ehk1tMw4qBIWvCgJj7rh) | Select a field whose data the Suggest should use. | | **Type of suggestion** ![](/files/UipZ5ADW4CYdVObCmdDS) | Select the Suggest type. Standard types are `productName` , `brand` ,`category` and `searchTerm`. | | **Add source field** ![](/files/2XF0kf1Bm7Z35I6UtFNL) | Add the selected field and its suggest type to the import. | | **Product data field** ![](/files/cVfuaDKK4FYgURysSN7J) | Overview of the product data fields used. Changes can be made directly in edit mode. | | **Suggest type** ![](/files/dOZlcoZrhcFshT4JyY3F) | Overview of the suggested types used. Changes can be made directly in edit mode. | | **Additional search data** ![](/files/afMFqoHYxlD3P4x4s54e) | Add another product data field. | | **Additional return dates** ![](/files/heY1jGf0d6KIgQt5tmq5) | | *** > **Remove search history and duplicates** [![](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040154/1/1659541645120/2021-04-09+14_43_43-Import+-+FACT-Finder-Management.png)](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040154/1/1659541645120/2021-04-09+14_43_43-Import+-+FACT-Finder-Management.png) In addition to its own search database, Suggest also gets its data from the **log files of the last few days**. **Search history** ![](/files/Ph63z0daepEWYQihI5Tp) can be used to determine how many should be included in the import. **Deactivate** this source to exclude search terms from shop visitors as suggestions. By default, duplicates are **removed** ![](/files/Ehk1tMw4qBIWvCgJj7rh) . The function can be disabled or customized by changing the mode. The options are: * **based on the entire list of suggestions** * **based on proposals of the same type** *** > **Advanced priority determination, determination of the exact number of results and preview images & suggest import settings** [![](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040153/1/1659541645128/2021-04-09+14_24_36-Import+-+FACT-Finder-Management.png)](https://doku.fact-finder.de/doc/files/ng3.1/65040137/65040153/1/1659541645128/2021-04-09+14_24_36-Import+-+FACT-Finder-Management.png) By default, priorities for suggestions are determined by NG similarity. If the **extended priority determination** ![](/files/Ph63z0daepEWYQihI5Tp) is active, the priority for each suggestion is determined during the import process by frequency of use and is linearly downgraded within the type. You can configure the maximum downgrading. To determine the exact number of results and preview images ![](/files/Ehk1tMw4qBIWvCgJj7rh), a ranked search database is used by default, taking the ranking into account. If this is not desired, you can deactivate the setting. For the **Suggest import settings** ![](/files/UipZ5ADW4CYdVObCmdDS), the following customization options are available: * **Reduce whitespace characters -** removes spaces at the beginning and end of the entry as well as multiple spaces between terms. * **Remove HTML code -** replaces HTML code with a space and decodes the HTML elements. Start and end tags are completely removed, multiple tags are replaced with a space. * **Convert special characters to ISO characters if necessary -** special characters such as typographic quotation marks are converted to ISO characters. * **Deduplicate field values -** multiple-occurring values in the return data are deduplicated, i.e. removed, so that they only occur once. * **Deduplicate content of the suggest search -** removes duplicates from the additional search data fields. * **Import at system startup -** if active, suggest database will be imported at system startup. > Settings made here take effect only after the Suggest data has been imported again. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.fact-finder.com/docs/import/selecting-suggest-product-and-search-data.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.