# Diagnostic Search

## Diagnostic Search Overview

The **Diagnostic Search** environment lets you quickly check search results and the general functionality of different modules.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-96ce9cf72c3610b463eaa73e6acb8450cb8d5cfe%2FDS_NEW_1-1.PNG?alt=media)

By entering a search term in the search bar ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-d6ef73369d8b6bd3c60991407ff7a93dc15afc93%2FB1-2025x25.png?alt=media) and pressing **Enter**, FactFinder retrieves relevant results.

Results are listed in a grid, including every attributes for products. There are also Filters ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-55f16c12a2be5027388834bf83e50265bb190316%2FB2-2025x25.png?alt=media) and Toolbar ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-6dbb1edbc49c774d93851bee61e1c5410654f86a%2FB7-2025x25.png?alt=media) panels. Detailed description and available functions for the grid and panels are described in chapters below.

## Search Results Grid

### Sorting

* Sorting to the grid can be applied by clicking column headers.
* Only fields with sorting enabled in the [field settings](https://docs.fact-finder.com/docs/basic-settings/fields) can be sorted.
* Arrows indicate the current sorting mode.
* **Default sorting** is descending by **Score.**

### Displayed Fields Configuration

The fields displayed in the grid can be specifically configured. Irrelevant fields can be hidden or non-searchable fields that are important for ranking analysis can be added.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-76dd873a4758a95489f22a7e2bc745cc022f495a%2FDS_NEW_2.png?alt=media)

* Fields configuration window is opened by clicking **Edit field display (5)** button.
* Fields can be quickly configured by default options:
  * Searchable fields - only searchable fields will be shown
  * Fields with roles - only fields with roles assigned will be shown
  * Custom selection - allow manually select fields to be shown
* It is possible to order fields representation in the grid by drag-n-dropping them by ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-87e6cca6cc0c6f782707c48c3b6321a8234b4fee%2Fimage-247.png?alt=media) icon
* Changes applied by clicking **OK** button or canceled by clicking **Cancel** button

### Sending Products to Trash

Products can be selected/unselected in the grid by clicking the checkbox

Selected products can be added to [Trash](https://docs.fact-finder.com/docs/discovery/search-term-rules/trash) directly from the grid using Trash option in Toolbar panel

### Checking Additional Info About a Product

Additional details for product score can be viewed by clicking **?** icon located in **Info** column:

* Overall score;
* Terms found;
* Field where search term is found
* Effect to the the score from the search term
* Effect of ranking
* Effect of ASO

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-255ce592ad567c6fe4a44a4aacdce7a2e7bb32af%2Fimage-248.png?alt=media)

### Substring Filtering

To quickly find specific results, **Substring filter** can be added to a field by using the filter input box in the header of the field.

It can also be used for queries that would not otherwise be possible and to create a more complex filtering:

* `___` can be used for `AND` operator,
* `~~~` for `OR` operator
* `!` for `NOT` operator

*For example, a filter that shows all products that do not contain the term "Women":*

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-c19ddb9f800e44998c67652427645ad2685788d9%2Fimage-249.png?alt=media)

If there is corresponding facet present, orange digit will be added to it in Filters panel indicating that substring filter is applied.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-d2e46f0b849af94f30913f82cf272f0f7dbb0c15%2Fimage-250.png?alt=media)

### Showing Blacklisted Products

Products added to the [Blacklist](https://docs.fact-finder.com/docs/basic-settings/suggest/suggest-blacklist) can be included into the search results in Diagnostic search by clicking checkbox located next to Edit field display button.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-ca1dccc2793e5bf41e63c22f5c684ace20ed853b%2Fimage-251.png?alt=media)

### Configure Weighting of Fields (Searchability)

It is possible to change the field weighting (searchability) of one or more fields directly from search results grid:

1. Enable [Edit configuration](https://docs.fact-finder.com/docs/user-interface/editing-configurations-managing-transactions) mode
2. Move the mouse over the respective column name and click on the **pencil icon** that appears

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-a012284845d11a1032058a57e4948120248c2655%2FDS_NEW_6.png?alt=media)

3. Input reduction percentage

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-769b724e3307394a425c3b7fb881da8373d8642f%2FDS2-5.png?alt=media)

4. Close to apply changes

> WARNING! This is a global change and will affect all searches.

## Filters Panel

**Filters panel** located on the left side of the Search results grid simulates filtering in the web-shop and can be used to filter out search results by various attributes.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-fa2dde9fd0b9aceddef088f1559fcc91774b0394%2Fdiagnostic-20search-20--20filters.png?alt=media)

* Filters panel can be **expanded** ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-d6ef73369d8b6bd3c60991407ff7a93dc15afc93%2FB1-2025x25.png?alt=media)
* Search, Navigation or None filter groups to be displayed can be selected with **Quick filter selection dropdown** ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-55f16c12a2be5027388834bf83e50265bb190316%2FB2-2025x25.png?alt=media)
* Additional filters can be added by **Add filter button** ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-d744db53a7fe2e10bd9c7fe0f3f5963ac5f7e742%2FB3-2025x25.png?alt=media)
* Filters can be removed by **cross-icon** ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-201fae191795364f088545807a1ef929d772dfcc%2FB4-20-2025x25-1.png?alt=media)
* Filters with applied values are highlighted with **green indicator** ![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-6f8ab95c0e762d2dd7f746a15c0c8b843a92d28a%2FB5-20-2025x25.png?alt=media)

## Toolbar Panel

**Toolbar panel** is located to the right side of the Search results grid and allows direct and quick access to various FactFinder functions. It also indicates (with green digit) which rules has been triggered or which entries are used by the search term.

![](https://883583471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTV1CIVFU3DJKhWzkqLAG%2Fuploads%2Fgit-blob-1ae2f747e25d7beaff2b363fff20f8ea1e5f9e27%2Fimage-253.png?alt=media)

* **Result Adjustments -** lets you show/hide effects caused by search term rules, campaigns and ranking rules
* **Preprocessor -** shows [preprocessor](https://docs.fact-finder.com/docs/discovery/search-term-rules/preprocessor) search rules triggered by the search term and lets you add new preprocessor entries
* **Stop words -** shows [stop words](https://docs.fact-finder.com/docs/discovery/search-term-rules/stop-words) search rules triggered by the search term and lets you add stop words entries
* **Thesaurus -** shows [thesaurus](https://docs.fact-finder.com/docs/discovery/search-term-rules/thesaurus) search rules triggered by the search term and lets you add thesaurus entries
* **Campaigns** - shows [campaigns](https://docs.fact-finder.com/docs/discovery/campaigns) using any products within the search results and allows adding new campaigns
* **Trash** - shows [trash](https://docs.fact-finder.com/docs/discovery/search-term-rules/trash) search rules triggered by the search term and lets you add trash entries
* **Relevance** - provides quick access to [Search algorithm](https://docs.fact-finder.com/docs/basic-settings/search-algorithm) settings
* **A/B test** - opens [test mode](https://docs.fact-finder.com/docs/modules/ab-tests)
* **Personalization** - lets you input a specific `Session ID` or `User ID` to simulate personalized search
* **Location** - lets you input a location to simulate [Geo module](https://docs.fact-finder.com/docs/basic-settings/fields/geo-fields) distance rule settings
* **Market selection** - lets you select specific markets if they are available
* **Display as** - lets you represent search results as `JSON`.
* **Export as** - lets you export search results as a `.csv` file
* **Custom parameter** - lets you add custom parameters: `key` on the left input and `value` on the right.