Skip to content
AI Search in Service Portal › Configuring search in a portal › Configuring Service Portal › Service Portal › Configure UIs and portals › Configure user experiences
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Define an AI Search Results Action

Configure which portal page opens when a result is selected from the list of search results.

Before you begin

Role required: sp_admin or admin

About this task

This configuration is required for UXF Client Action buttons in genius results or search results cards.

Note: If the action is being implemented as a server script, the script is executed by the search widget. Notification messages defined in the server script are displayed.

Procedure

  1. Navigate to All > Service Portal > AI Search > Search Results Action and select New.

  2. On the form, fill in the fields.

FieldDescription
Short descriptionA unique description of the search results action.
Service Portal\(s\)Portals in which the search results action appears. If left blank, the search results action appears in all active portals.
AI Search SourceContent that portal users can search on, including tables in your instance or external data sources. For more information, see Defining search sources.
Action nameName of the action assignment. Only navigation actions are supported for selecting a search result in portals.
ApplicationApplication scope of the search results action.
ActiveOption to activate the search results action.
OrderPriority that the search results action takes over other actions with the same configuration. To give higher priority to an action, enter a lower number. If two actions have the same order, then the oldest action takes priority.
Portal pagePage on that opens when a result from the search source is selected from the list of search results.
Payload query parameters

Query parameters to apply to the URL.

  • In the first drop-down, select the payload fields that correspond to the selected Action name.

Note: You can find the payload fields by opening the record referenced in the Action name field. Then, in the Action Assignment record, open the record referenced in the Specify client action field. The Payload field in the Action Payload Definition record specifies the fields used.

  • In the next field, enter the query parameter to use in the URL.
Additional query parametersCustom query parameters to use in addition to the payload query parameters. For example, to add view=sp as a query parameter, you would enter view and sp in the Name and Value fields, respectively.
  1. Select Submit.

Parent Topic:AI Search in Service Portal