# Configuring Search Box

The power user can set the following preferences for the Search Box component.

When you first open Search Box preferences, you see a list of existing search configurations:

When you select a search configuration, or click Add Configuration, Search Box preferences updates to include options for type-ahead configuration:

- Search Configurations: You can add, remove, or edit configurations that are based on the following criteria:
  - Display Name: The name used in breadcrumbs.
  - Default: Choose which search configuration is the default.
  - Data Source: Select one of the available data sources to associate with this search configuration.
  - Search Interface: Select from the search interfaces defined in this data source. The search interface limits the end user's search, and allows you to control record search behavior for groupings of some number of dimensions, properties, attributes, and ranking strategies.
  - Match mode: Select a match mode from the drop-down list. Match modes allow you to specify a less restrictive matching strategy than the default conjunctive MatchAll.
  - Target Page: Optionally, set the target page for any page transition. Page transitions allow a component on one page in your Discovery Framework application to pass data to a component on another page. In the example below, data will be sent to a component on the Comparisons page.

    In addition, by clicking in the label of any column, you can sort the contents of that column and remove columns from the Search Configurations display.

- Enable type-ahead suggestions: Check to enable the MDEX Engine to start offering suggestions before the user has typed a complete search term. If Enable type-ahead suggestions is not selected, none of the remaining controls appear in the Search Box preferences.

  Important: Dimension search wildcarding must be enabled in the MDEX Engine in order for type-ahead to work in Discovery Framework components.
- Minimum characters to trigger suggestions: Set the minimum number of characters needed before type-ahead suggestions are offered.

- Maximum suggestions per dimension: Set the maximum number of type-ahead suggestions the MDEX Engine will offer for each dimension.

- Maximum total suggestions: Set the maximum total number of type-ahead suggestions the MDEX Engine will offer. If fewer results are available, the number returned will be less than this maximum.

- Show intermediate values: Check this box to display the full path for hierarchical results.

- Dimension Configuration: Check Included to include all dimensions in the type-ahead results. Alternatively, the power user can search for a dimension, or select dimensions individually, to customize which dimensions are included.