Create or edit an EVAM view definition
Create or edit an Entity View Action Mapper (EVAM) view definition in the AI Search Admin console to customize how your AI Search results appear in the portal or workspace.
Before you begin
Role required: admin or ais_admin
About this task
An EVAM is a data source type tool that helps standardize how data appears in lists and cards. An EVAM lets you combine data from multiple sources, set up views for each source, and browse large data sets more easily. When you create or edit an EVAM definition, you can define which conditions, fields, and declarative actions to use and pair them with a view template. This setup lets you customize the result-card interface to your needs.
Procedure
-
Navigate to All > AI Search Admin > AI Search Admin Home.
-
On the Applications tab, select the application card that you want to create or edit the EVAM configurations for.
-
In the left pane, select Result-card Interface.
The result-card Interface shows the configured EVAM definition. You can modify the existing EVAM definition or if you’re configuring your application for the first time, you can add an EVAM definition. For more information, see step 4.
-
Update an existing EVAM definition or add a definition.
- To update the existing EVAM definition for the result-card interface, select Change.
- To add an EVAM definition and configure the result-card interface for the first time, select Choose.
- Create or update an EVAM definition for the result-card interface.
|
Option |
Procedure |
|---|---|
|
Select from the existing result-card interfaces for your search application |
|
|
Add a new result-card interface for your search application |
|
-
From the Select a bundle to edit list, select an EVAM configuration bundle.
You can link more bundles to the selected EVAM definition by selecting Advanced configuration. For more information, see Create an EVAM definition.
The list of view configurations that are associated with the selected bundle are displayed.
-
Manage the EVAM view configuration.
|
Option |
Procedure |
|---|---|
|
Create an EVAM view configuration |
|
|
Edit the existing EVAM view configuration |
|
For a description of the field values, see [Edit view config form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/search-administration/ais-edit-view-config-form.md).
-
In the Preview Card section, review the auto-generated JSON to verify the edits that you made to the view configuration.
The following example shows the Edit view config form that helps you review the layout of your result-card interface in the Preview Card section.
[Omitted image "edit-view-config1.png"] Alt text: Edit view config form showing the preview card. [Omitted image ""] Alt text:
-
Select Save.
Result
Changes made to search result EVAM cards take effect immediately in AI Search applications.
What to do next
After creating a view configuration, you must activate it. For more information, see Activate or deactivate an EVAM view configuration.
Parent Topic:Customizing the result-card interface of an AI Search application by using EVAM
---
title: Create or edit an EVAM view definition
description: Create or edit an Entity View Action Mapper \(EVAM\) view definition in the AI Search Admin console to customize how your AI Search results appear in the portal or workspace.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-administration/search-administration/ais-admin-console-evam-configurations.html
release: brazil
product: Search Administration
classification: search-administration
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 3
keywords: [ServiceNow Otto, AI Agents, generative AI, agentic AI]
breadcrumb: [Customizing the result-card interface of an AI Search application by using EVAM, Using AI Search Admin console, AI Search Admin console, Search administration, Configure core features, Administer the ServiceNow AI Platform]
---
# Create or edit an EVAM view definition
Create or edit an Entity View Action Mapper \(EVAM\) view definition in the AI Search Admin console to customize how your AI Search results appear in the portal or workspace.
## Before you begin
Role required: admin or ais\_admin
## About this task
An EVAM is a data source type tool that helps standardize how data appears in lists and cards. An EVAM lets you combine data from multiple sources, set up views for each source, and browse large data sets more easily. When you create or edit an EVAM definition, you can define which conditions, fields, and declarative actions to use and pair them with a view template. This setup lets you customize the result-card interface to your needs.
## Procedure
1. Navigate to **All** > **AI Search Admin** > **AI Search Admin Home**.
2. On the **Applications** tab, select the application card that you want to create or edit the EVAM configurations for.
3. In the left pane, select **Result-card Interface**.
The result-card Interface shows the configured EVAM definition. You can modify the existing EVAM definition or if you’re configuring your application for the first time, you can add an EVAM definition. For more information, see step 4.
4. Update an existing EVAM definition or add a definition.
- To update the existing EVAM definition for the result-card interface, select **Change**.
- To add an EVAM definition and configure the result-card interface for the first time, select **Choose**.
1. Create or update an EVAM definition for the result-card interface.
<table id="table_rq1_hrd_1dc"><thead><tr><th>
Option
</th><th>
Procedure
</th></tr></thead><tbody><tr><td>
Select from the existing result-card interfaces for your search application
</td><td>
1. Select **Use an existing result-card interface**.
2. From the Result card interface list, select an option.
</td></tr><tr><td>
Add a new result-card interface for your search application
</td><td>
1. Select **Create new interface**.
2. In the **Configuration name** field, enter the name.
</td></tr></tbody>
</table> 2. Select **Save**.
5. From the Select a bundle to edit list, select an EVAM configuration bundle.
You can link more bundles to the selected EVAM definition by selecting **Advanced configuration**. For more information, see [Create an EVAM definition](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/define-composite-dataset.md).
The list of view configurations that are associated with the selected bundle are displayed.
6. Manage the EVAM view configuration.
<table id="choicetable_s32_yx1_cdc"><thead><tr><th align="left" id="d381813e391">
Option
</th><th align="left" id="d381813e394">
Procedure
</th></tr></thead><tbody><tr><td id="d381813e400">
**Create an EVAM view configuration**
</td><td>
1. Select **Create New**.
2. In the Create new view config dialog box, review the auto-populated values, and then select **Create**.
</td></tr><tr><td id="d381813e428">
**Edit the existing EVAM view configuration**
</td><td>
1. From the View configs list, identify an EVAM view configuration that you want to edit.
2. Select the **More Actions icon \[Omitted image "more-actions-icon.png"\] Alt text: More Actions.** > **Edit**.
</td></tr></tbody>
</table>7. On the form, fill in the fields.
For a description of the field values, see [Edit view config form](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/search-administration/ais-edit-view-config-form.md).
8. In the Preview Card section, review the auto-generated JSON to verify the edits that you made to the view configuration.
The following example shows the Edit view config form that helps you review the layout of your result-card interface in the Preview Card section.
\[Omitted image "edit-view-config1.png"\] Alt text: Edit view config form showing the preview card. \[Omitted image ""\] Alt text:
9. Select **Save**.
## Result
Changes made to search result EVAM cards take effect immediately in AI Search applications.
## What to do next
After creating a view configuration, you must activate it. For more information, see [Activate or deactivate an EVAM view configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/search-administration/enable-evam-config-ais-admin-console.md).
**Parent Topic:**[Customizing the result-card interface of an AI Search application by using EVAM](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/search-administration/ais-admin-console-managing-evam.md)
| title | Create or edit an EVAM view definition |
| description | Create or edit an Entity View Action Mapper \(EVAM\) view definition in the AI Search Admin console to customize how your AI Search results appear in the portal or workspace. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/platform-administration/search-administration/ais-admin-console-evam-configurations.html |
| release | brazil |
| product | Search Administration |
| classification | search-administration |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 3 |
| keywords | ServiceNow OttoAI Agentsgenerative AIagentic AI |
| breadcrumb | Customizing the result-card interface of an AI Search application by using EVAMUsing AI Search Admin consoleAI Search Admin consoleSearch administrationConfigure core featuresAdminister the ServiceNow AI Platform |