Search functionality | custom workspace

vimaljain
Tera Contributor

The search functionality available in the header bar currently works for existing workspaces. It provides a Global search option along with workspace-specific search scopes, and when a record is searched within an application, the result opens directly in the corresponding workspace.

I have created a new workspace and would like to enable the same search functionality for it. Could you please guide me on the required configuration changes or share any relevant documentation for setting this up?

3 REPLIES 3

Ankur Bawiskar
Tera Patron

@vimaljain 

check below

how to configure global search in workspace to show only current application records on searching? 

Add a workspace application to the Unified Navigation search context menu 

💡 If my response helped, please mark it as correct and close the thread 🔒— this helps future readers find the solution faster! 🙏

Regards,
Ankur
Certified Technical Architect  ||  10x ServiceNow MVP  ||  ServiceNow Community Leader

PavanBalajT
Tera Contributor

<p> Hii @vimaljain ,

 

Step 1: Map the Search Application Configuration

You first need to define the globalSearchDataConfigId property so your workspace knows which search engine/configuration to use.

  1. Navigate to All > AI Search > Search Experience > Search Applications.

  2. Open the search application configuration record matching your workspace type (e.g., if it's an agent-facing workspace, you can copy from the Agent Workspace Search Config).

  3. Click the Additional actions (hamburger) menu icon and select Copy sys_id.

  4. Navigate to the UX Page Property [sys_ux_page_property] table by typing sys_ux_page_property.list in the application filter navigator.

  5. Click New and fill in the form fields:

    • Page: (Select the UX Application record for your new custom workspace)

    • Name: globalSearchDataConfigId

    • Type: string

    • Value: (Paste the sys_id you copied in Step 3)

  6. Click Submit.


Step 2: Configure Workspace Search Settings

Next, map the global_search_configurations property to tell the Next Experience framework how to route search results.

  1. While still in the application filter navigator, type sys_search_context_config.list to open the Search Context Configurations.

  2. Open the Workspace search settings record (or your custom workspace search config record if you have built a unique one).

  3. Click the Additional actions icon and select Copy sys_id.

  4. Return to the UX Page Property table (sys_ux_page_property.list) and click New:

    • Page: (Select your custom workspace UX Application record)

    • Name: global_search_configurations

    • Type: json

    • Value: Enter the following JSON snippet, replacing YOUR_SYS_ID_HERE with the sys_id you just copied:

      JSON
       
      { 
        "globalSearchViewConfigId": "YOUR_SYS_ID_HERE", 
        "globalSearchRoute": "search" 
      }
  5. Click Submit.


Step 3: Explicitly Enable Search in the Header Bar

Finally, ensure the search functionality is visually turned on inside the Next Experience header for your workspace.

  1. Go back to the UX Page Property table (sys_ux_page_property.list).

  2. Search for an existing record where the Name is chrome_header and the Page matches your custom workspace.

    • If the record exists: Open it and edit the value to make sure "searchEnabled": true is specified inside the JSON string, then click Update.

    • If the record does NOT exist: Click New and fill it out manually:

      • Page: (Select your custom workspace UX Application record)

      • Name: chrome_header

      • Type: json

      • Value: ```json

        {

        "privatePage": {

        "searchEnabled": true

        }

        }

  3. Click Submit.


Verify Changes


Please mark this response as Helpful & Accept it as solution if it assisted you with your question.
Regards. </p>