---
sourceDocument: Xanadu ServiceNow AI Platform user interface
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/platform-user-interface

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Faceted Search widget

# Faceted Search widget {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

The Faceted Search widget displays search results and search facets defined for a search source. The Faceted Search widget enables end users to filter search results for a more meaningful result set.

## Using the widget {#faceted-search__section_lrw_kzp_5mb}

You can use facets, tabs, and breadcrumbs to refine your search in Service Portal. For example, you can filter search results to only knowledge articles by selecting the Knowledge tab. Or, to filter search results by certain knowledge categories, you can select one or more facets.Figure 1. Faceted Search widget

The available facets are dynamic and based on the search. As you select facets, the search
narrows and the number of available facets decreases. You can see which facets you've selected
by viewing the pills in the facets panel. If you select a different tab, the selected facets are
carried over and applied to the search criteria.

You can broaden your search by clearing an individual facet selection or selecting the
All tab. To clear all facet selections, select Clear all.

You can initiate a new search by entering a new search term in the typeahead search box. After
you enter the new search term, the system clears the facet and tab selections from the previous
search. You can refine your new search by selecting new facets or tabs.

For more information on configuring the available facets, see [Create a facet in an AI Search application
configuration](https://www.servicenow.com/docs/access?context=create-facet-ais&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## Instance options {#faceted-search__section_mz1_lzp_5mb}

Use the instance options to configure the Faceted Search widget for a portal page.{#faceted-search__table_rm5_ksh_zz__entry__2}

| Field | Description |
|-|-|
| Presentation ||
| Facet List Title | Display title for the facet component. |
| Typeahead Search - Title | Default text in the typeahead search component. |
| Typeahead Search - Color | Whether the glyph in the typeahead component is filled in. |
| Typeahead Search - Glyph | Icon that appears in the search field beside the widget. The search icon is the default. To use a different icon, type the name of the icon in the field, for example <kbd class="ph userinput">search-plus</kbd>. For a list of icons to choose from, open the instance options for the Icon Link widget. |
| Typeahead Search - Size | Determines the font size and height of the widget. Choose from xs, sm, md, and lg. |
| Show Typeahead Search Box | Option to show or hide the search box on the portal page. |
| Behavior ||
| Max results for All search | Maximum number of results that display for all search sources when viewed together. |
| Max results for single search source | Maximum number of results that display for a single search source. |
| Show Did You Mean | Displays suggestions when a search produces no results. |
| Typeahead Search - Limit | Number of typeahead search results displayed. The default is 15. |
| AI Search ||
| Placeholder | Text that appears in the search box before the user enters anything. By default, the placeholder text is Search. Note: This instance option applies only if AI Search is enabled in your portal. For more information on enabling AI Search for Service Portal, see [Enable and configure AI Search in Service Portal](https://www.servicenow.com/docs/pOfJYUbWSo3VRAdLplZaNQ "Enable and define the AI Search experience in your portal."). |
[ ]

{#faceted-search__table_rm5_ksh_zz}
**Related tasks**   

* [Create and edit a page using the Service Portal Designer](https://www.servicenow.com/docs/HJxxVRb43STfSwKwkTcI9g#t_ConfigureAPage "Create or edit a page and use layouts to organize the columns that house the widgets.")
* [Configure widget instances](https://www.servicenow.com/docs/_ZsWpeV1a5fqufBctXNjbw "Create unique instances of widgets by configuring the options for each instance.")
* [Clone a widget](https://www.servicenow.com/docs/76cLuA4TQ1KSQSxGucOcbQ "Take advantage of existing code by cloning and editing an existing widget.")