Typeahead Search widget

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
  • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Typeahead Search Widget

    The Typeahead Search widget is a predictive search tool that enhances user experience by displaying suggestions as they type. This widget can be used as-is on your portal or customized to meet specific business requirements.

    Show full answer Show less

    Key Features

    • Instance Options: Configure various settings for the widget display on a portal page, applicable only if AI Search is enabled.
    • Presentation Title: Customize the text displayed in the search field before user input (e.g., "Search" or "What are you looking for").
    • Color & Icon: Control the appearance of the search button and choose icons to display alongside the search field.
    • Size: Adjust the font size and height of the widget with options from extra small (xs) to large (lg).
    • Behavior Limit: Set the number of displayed suggestion or typeahead entries, defaulting to 15.
    • Contextual Search Sources: Limit search results to specific sources, enhancing relevance (e.g., Service Catalog only results).
    • AI Search Application: Configure search engine settings, result limits, and suggestions at the widget level.
    • Search Results Configuration: Override the default display settings for search results.
    • Disable Suggestions: Option to turn off search suggestions altogether.
    • Placeholder Text: Default text in the search box before user input, typically "Search."
    • AI Search Source Filter: Define searchable content including internal tables and external data sources.

    Key Outcomes

    By effectively using the Typeahead Search widget, ServiceNow customers can significantly improve user navigation and search efficiency within their portals, providing a tailored search experience that meets specific business needs. This leads to enhanced user satisfaction and productivity.

    Predictive search feature that shows words as users type. You can use this base system widget as-is in your portal or clone it to suit your own business needs.

    Figure 1. Typeahead Search widget
    Typeahead Search widget

    Instance options

    Use the instance options to configure the Typeahead Search widget for a portal page.
    Note:
    The AI Search instance options apply 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.
    Field Description
    Presentation
    Title The name or words that appear in the search field before a user starts typing. For example, search or what are you looking for
    Color Whether the search button beside the search field is filled in or not
    glyph The 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 search-plus. For a list of icons to choose from, open the instance options for the Icon Link widget.
    Size Determines the font size and height of the widget. Choose from xs, sm, md, and lg.
    Behavior
    Limit If search suggestions is enabled, enter the number of suggestion entries you want to display. If search suggestions is disabled, enter the number of typeahead entries you want to display. The default is 15. See Enable and disable search suggestions.
    Contextual Search Sources Limit the results available in the typeahead search by only configuring specific search sources. For example, users searching in the Service Catalog only see results for the Service Catalog when that search sources is configure. For more information on contextual search, see Configure Search Sources available on a page
    AI Search
    Search Application

    Defines search experience settings for the widget, such as the search engine, search results limit, and suggestions limit. By default, the widget uses the same search application configuration as the portal, but you can override this configuration at the widget level.

    For more information on defining a search application configuration, see Defining search application configurations.

    Search Results Configuration

    Defines how search results are displayed after using the widget. By default, the widget uses the same search results configuration as the portal, but you can override this configuration at the widget level.

    For more information on defining a search results configuration, see Define a composite dataset.

    Disable All Suggestions

    Option to disable search suggestions.

    Placeholder

    Text that appears in the search box before the user enters anything.

    By default, the placeholder text is Search.
    AI Search Source Filter Content that portal users can search on, including tables in your instance or external data sources. For more information, see Defining search sources.