--- title: "Search Box" slug: "search-box-1" updated: 2025-05-23T09:38:28Z published: 2025-05-23T09:38:28Z canonical: "help.symphonysummitai.com/search-box-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Box > [!NOTE] > Note: > > The **Tree Attributes** for **Search Column** and **Display Columns** fields - improvement is released in Crescendo 6.3.1.1 release. The **Search Box** in a **Service Porta**l enhances user experience by enabling quick access to relevant information, allowing efficient navigation without manual browsing. It improves efficiency, enhances self-service capabilities, and reduces dependency on support teams. In the **General Widgets** of the **Service Portal**, **Incident Rule Templates** and **Service Catalogs** are added in the **Search Box** properties **User Persona:** Application Designer Let us explore the following Use Case for designing the **Search Box** widget! | **Use Case** **User Persona:** **Application Designer** | **Solution** | | --- | --- | | Sam, needs to find the Incidents, Service Requests, Catalogs, and Templates in the self-service portal. Without an efficient search box, navigating through multiple sections is time-consuming, leading to delays in resolving customer queries. | A **Search Box** widget enables Sam to quickly locate relevant articles by entering keywords, reducing search time, improving self-service efficiency, and enhancing customer support response times. | #### Configure Search Box in General Widgets The Search Box in General Widgets helps users quickly find relevant information, improving navigation and efficiency. Configuring it ensures seamless access to records, enhancing the overall user experience. To configure the **Search Box** widget, perform the following steps: 1. Navigate to **Design Portal** > **Widgets** > **General Widget** > **Search Box.** The **Service Portal Details** page is displayed. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/design portal(1).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=L9eLMqv6N2jLOuWB9UWCrfPxAFIeicVicMl7j4Ne9oM%3D) Figure: Search Box 2. Drag and drop the **Search Box** widget on the Layout. 3. Hover the mouse on the **Search Box** widget, click ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-LLD9TSFB.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=nnaXqLBcmO4lwdmrJi%2F8flBJ%2FBj3N0dYaCvsbsTGcts%3D) **Settings** icon to configure the Search Box widget. The configuration window appears with the following tabs: - [Properties](/summit-platform/docs/search-box#properties) - [Search Results](/summit-platform/docs/search-box#search-results) - [Appearance](/summit-platform/docs/search-box#appearance) #### Properties The **Properties** tab allows you to configure the basic settings of the **Search Box** widget. **Watermark:** The Watermark field defines the placeholder text that appears inside the **Search Box** before the user types query. Users are able to customize this text to guide users, such as Search for Service Requests, Incidents, Incident Rule templates, or Knowledge articles. These settings help improve user experience by providing clear guidance on how to use the search box. Navigate to **Properties** tab and enter the description for the **Watermark**. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/properties(5).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=kP9sFTLgEKHgkzu00xvkTXhldBtXEWOZNZvg%2BhpJklw%3D) Figure: Properties tab #### Search Results for Incident Rule Templates and Service Catalogs **Search Results** tab allows Administrator to define how search queries are processed and displayed. This section enables configuration of data sources, filtering, and display settings to ensure users receive relevant search results. This section provides options to configure the **Data Source**, **Scope**, and **Search Display** settings. To configure the **Search Results** section, perform the following steps: 1. Navigate to **Search Results** tab. 2. Click the ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-5RMHF5HM.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=ZHpbSUHWqvfZwdjXfKC655BrehM9pGC64QahZZqnV%2FU%3D) edit icon on the **General** tab. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/search results1.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=vEXS4JCWKx%2FIbSfampr18DI7BEDacvXa%2Bm%2BWQINR6%2Fg%3D) Figure: General tab 3. A new popup window **Edit Tab** appears. Enter a name in the **Tab Name** field. Upload an icon in the **Icon Upload** field. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Edit tab(1).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=DgSNxHfPoSsMffHzyrFURy05V2lDUufiDirVH53VkHc%3D) Figure: Edit Tab 4. Click **Update** to update the Tab name. 5. Click + icon to Add multiple tabs for different search results. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Add.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=75HAvtTdTPm8UU7%2Bj0OWkMMUYwRAK3DV6c1v16suIkY%3D) Figure: Add 6. Select the check box of **Include All Tab** to include additional tabs if needed. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/1(41).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=YsxXpLrx2o2AG00UzDZkcGmQuG11lM7BgbXDVMKXK2o%3D) Figure: Include All Tab 7. Enter all mandatory fields in the **Data Source** section. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Data source(1).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=mLhTvYs002wDOe1VoAPjH4bxPvFQ8uA2%2Bkg6%2FeX%2BCXg%3D) Figure: Data Source The following table lists the fields available in the **Properties** section and their descriptions. Field Description | General | | --- | | Data Source | | Source* | Select the type of **Data Source** from the dropdown list. By default, **Internal** is selected in the Source. Types of Data Sources available are: - Internal - External | | Application* | Select the **Application** to fetch data. By default, **Service Management** is selected in the Application dropdown list. Applications listed are: - Asset Management - Discovery - HR Service Management - Service Automation - Service Management | | Module* | Select the Module name from the dropdown from where the data has to be fetched. This list includes all modules available within the selected application. Modules available are: - Call - Incident - Service Request - Knowledge - Change - Problem - Release - Workorder - CMDB | | Table* | Select the **Table** that contains all source tables (Database Tables) for the selected Module. Forms available are: - Admin Form - Transaction Form - Templates ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Templates.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=BAbFl6d4%2FNlXn%2Brt8JeV3Mno1V2H3WtLrcyqo986yzc%3D) Figure: Templates - Catalogs ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Catalogs(3).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=qb5xbAS%2BDRiy3qptWKmvNfW8mMPyoREYXqzDgnN9%2Fbw%3D) Figure: Catalogs > [!NOTE] > Note > > - For the **Incident Management**, select **Incident** as Module and then select **Templates** from the dropdown list. Based on the table selection, the search column options are displayed. > - For the **Service Management**, select **Service Request** as Module and then select **Catalogs** from the dropdown list. Based on the table selection, the search column options are displayed. | | Search Column* | The **Search Column** defines the fields (or columns) that are used to perform searches within a dataset or form. It allows users to select one or more columns from which the system will retrieve matching records during a lookup or filtering operation. Tree attributes can be configured in Search Columns. They enable filtering based on leaf node values and display data such as Categories, Classifications, or Locations. This helps refine search results by allowing navigation through structured levels of information. For example, in Service Management (SM), with the hierarchy **Access Management** > **Remote Access** > **VPN Access**, when a user searches for VPN Access, only the leaf nod**e VPN Access** is shown in search results. Parent attributes like **Access Management** and **Remote Access** will not appear. (Tree attributes are supported only in Main Form tables). ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Display columns(2).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=dy2wGyAf55x60ArNDzmOUuhW259CCypiMSIQRjg1RgA%3D) Figure: Tree attributes in Search Column > [!NOTE] > Note > > - Tree attributes support navigation through different levels of a hierarchy and typically operate on the lowest level, known as the leaf node, when searching or displaying data. > - Including Tree Attributes in Search Column may impact search performance. > - When the user searches for the columns, only the **Search Columns** selected for the chosen Table must be displayed. > - For the **Incident Management**, Category columns for the Incident are displayed. > - For the **Service Management,** Classification columns for the Service request are displayed. | 8. Navigate to **Scope** section, Click ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-KC83BBM8.png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=bc48etYFQUL6BCMKDLhUHMdLO976E3v4Q6eUbmsYRWY%3D) **Add Filter Set** to configure the condition. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Scope(1).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=xTMoQLC55igrAa%2BvPsnOzAhVCwn9KKw%2FyyzpkPa6pF8%3D) Figure: Scope The following fields lists the fields available in the Scope section and their descriptions. **Field Description** | Scope | | --- | | Field | Select a record from the dropdown menu. The available options depend on the table selected in the **General Details** tab. | | Operator | Choose an **Operator** that defines the condition for the value. The available operators vary based on the selected field type, such as text or numeric. | | Value | Enter or select the required value. | 9. Navigate to **Search Display** section and enter all the mandatory fields. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Search display(2).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=Qa4SP3VUP0%2BAhwgzS52adL86u7SdmUK6psIZKCqog58%3D) Figure: Search Display The following fields lists the fields available in the Search Display section and their descriptions. Field Description | Search Display | | --- | | Display Columns* | Choose the **Display Columns** to display. When searching for a specific record, users are able to configure which columns appear in the search results. Tree attributes such as Categories, Classifications, and Location are displayed. They enable filtering based on leaf node values. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Displaycolumn(3).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=NACWGXi0NT1l%2FIboOWybi2I5xtAt9UssOM%2BFu3oYTO4%3D) Figure: Tree attributes in Display Columns | | Form* | - In the Data Source, if the **Table** is set to **All Catalogs**, the **Form** field is automatically populated, with the **Sub-Form** option auto selected. - For other tables, select a **Form** based on the chosen table. The Form dropdown generates forms based on the selected persona. > **Note:** > > - If Administrator is selected as the persona in the General step, all corresponding forms are displayed. > - If Analyst is selected, only the forms relevant to the Analyst are shown. > - If End User is selected, only the forms applicable to the End User are displayed. | | Open Mode* | Defines how search results **Open** (For example, Self-Window or a New Tab) | | Max Search Results | Displays the **Maximum number of Search Results** | 10. Click **Save**. #### Appearance The **Appearance** tab enables users to customize the visual layout, colors, fonts, and UI elements to enhance usability in the Search Box. It helps in maintaining consistency, improving readability, and ensuring a user-friendly interface. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Appearance(5).png?sv=2026-02-06&spr=https&st=2026-11-22T14%3A56%3A11Z&se=2026-11-22T15%3A56%3A11Z&sr=b&sp=r&sig=VNLIkrVYy79lZbPIJ5Ckrh9decEKJMb86q8qAB95EhA%3D) Figure: Appearance The following table provides a list of available fields and their descriptions in the Appearance tab. | Name | Description | | --- | --- | | Search Box | Select the Text Type, Text Color, Text Size, Text Style, Border, and Background Color. | | Search Body | Select the Border and Background Color. | | Tab Heading | Select the Text Type, Text Color, Text Size, Text Style, and Highlight Text Color. | | Result Text | Select the Text Type, Text Color, Text Size, and Text Style. | | Dimensions | Select the Height and Width. | 1. Once you configure the necessary properties, click **Save** to apply the changes or **Cancel** to discard them.