> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Third-Party Search Tools

## Splainer

<Card title="Watch: Splainer.io" icon="circle-play" href="/video/search-splainerio" horizontal data-rec="video">
  Learn how to use Splainer.io for debugging and analyzing search results
</Card>

Splainer is an open-source, third-party tool from OpenSource Connections. It has been integrated with the Kibo Composable Commerce Platform in order to provide insight into search relevancy and results.

1. To access, click the **Splainer.io** button. A unique URL is generated with parameters from the search configuration.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/search-settings-splainer-button.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=aff04ba29b738a26e17df4b4b93e90c2" alt="Search settings page with an arrow pointing to the Splainer.io button" width="1055" height="114" data-path="img/search-settings-splainer-button.png" />
2. Clicking the button will open Splainer with those parameters in a new browser tab. Since this is generated from a configuration, no search term is populated. To enter and see the results of a specific term, click **Tweak** in the top right of the screen.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/splainer-tool-initial-results.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=80d9fc0fa244460267915a04fdd8ee94" alt="Splainer initial results page with an arrow pointing to the Tweak button" width="822" height="617" data-path="img/splainer-tool-initial-results.png" />
3. Enter the desired search term after `query=` and then click **Rerun Query**.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/splainer-tweak-enter-search-term.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=eeaa96439750642ac081af16fb87620d" alt="Splainer screenshot with a box showing where to enter the search term and an arrow pointing to the Rerun Query button" width="217" height="540" data-path="img/splainer-tweak-enter-search-term.png" />
4. The results on the left will refresh based on the search term. Click **Details** to see an explanation of what makes the relevancy score.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/splainer-detailed-arrow.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=2119a989dc39281e7ed03753fc8f801e" alt="Splainer results with an arrow pointing to the Detailed link" width="790" height="393" data-path="img/splainer-detailed-arrow.png" />
5. Within the Detailed modal, click **Full Explain** to see what exactly causes an item to have a particular relevancy score.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/splainer-detailed-modal-full-explain-arrow.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=8114d35fddb414485294e9dad86c2b3c" alt="Splainer detailed modal with an arrow pointing to the Full Explain link" width="717" height="289" data-path="img/splainer-detailed-modal-full-explain-arrow.png" />
6. This list can be expanded to see as many or as few details as needed.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/ByE7VB0BBLbMBpJV/img/splainer-detailed-modal-full-explain-expanded.png?fit=max&auto=format&n=ByE7VB0BBLbMBpJV&q=85&s=4445641db1b3edcb64a8e6134037fa3f" alt="Splainer Full Explain results with arrows pointing to the expand buttons" width="715" height="546" data-path="img/splainer-detailed-modal-full-explain-expanded.png" />

More information about using Splainer can be found by clicking **Take a Tour** at the top of the Splainer UI.

## Quepid

Quepid is an open-source, third-party application from OpenSource Connections. It has been integrated with KCCP in order to help merchandisers and search relevancy engineers view search results without changing settings and checking results on a live retail site. Quepid provides visibility into how changes affect the site globally, while Splainer provides deeper details about individual relevancy scores.

You must create a free account with Quepid in order to use it.

1. Visit the [Quepid application](https://www.quepid.com/).
2. Copy the URL generated when clicking the Splainer.io button.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-splainer-url-highlighted.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=3f725916a5a92ad00b3be063364b16b9" alt="Splainer screen with the generated URL higlighted" width="214" height="267" data-path="img/quepid-splainer-url-highlighted.png" />
3. On the initial screen, choose SOLR, insert the copied URL, and click **Continue**.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-intro-screen.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=3f2457de95fa827b99c11015b676aa00" alt="Quepid introductory screen with arrows pointing to the search type toggle, the URL entry, and the Continue button" width="590" height="408" data-path="img/quepid-intro-screen.png" />
4. Enter the fields to display. The list of available options for each field is generated by your uploaded catalog schema.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-fields.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=fcc66a4f6ea1a75621aced2d9f2c8e9a" alt="Quepid results display options" width="590" height="373" data-path="img/quepid-fields.png" />
5. Add one or more search terms, then click **Continue**.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-search-terms.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=c18819d4656d361032bc1f01037749fe" alt="Quepid search queries" width="589" height="198" data-path="img/quepid-search-terms.png" />
6. Click **Finish** to close the modal and view the results.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-finish-modal.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=7c0a63d6e5f294799808601e15c62755" alt="Quepid final setup screen" width="589" height="224" data-path="img/quepid-finish-modal.png" />
7. By default, the results will contain all products instead of those specific to your search terms. To adjust the accuracy of the results by restricting them to your search terms, click **Tune Relevance** and then change `q=#$query##` to `query=#$query##`. <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-tune-relevance.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=bc1a8531b5415e6c1b2e799d28eb22c3" alt="Callout for the Tune Relevance link in the page header" width="1073" height="153" data-path="img/quepid-tune-relevance.png" /><img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-tune-relevance-query.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=3b763f452cdee23fcbb5661841ced86b" alt="The Query Sandbox options with a callout for the query" width="783" height="291" data-path="img/quepid-tune-relevance-query.png" />
8. Then, you can further expand a query by clicking the down arrow on the results page.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-expand-query.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=aff3c5d4d22307c44b9a43f37c40bd20" alt="Quepid results screen with an arrow pointing to an expand drop-down arrow" width="1074" height="396" data-path="img/quepid-expand-query.png" />
9. For each result, click the drop-down option to the left and select a relevance score. In this example for the search term *pants*, the deck bag has been scored as Irrelevant, while the cargo crop pants have been scored as Relevant.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/qmFTB-INEzgu11uM/img/quepid-tune-relevance-341a18.png?fit=max&auto=format&n=qmFTB-INEzgu11uM&q=85&s=39658620ec853b6dd18cd8d7d371b505" alt="Quepid results screen with an arrow pointing to the relevance score of the last item" width="1032" height="486" data-path="img/quepid-tune-relevance-341a18.png" />
10. As each item is scored, the overall score for the query is automatically adjusted. This provides the ability to see if various search configuration changes improve search results or not.

More information about using Quepid may be found on the [Quepid Knowledge Base](https://quepid.com/docs/).
