---
title: "Configure Search Bar for CDT"
slug: "configure-search-bar-for-cdt"
description: "Follow these steps to define and configure a header-level Search bar for the CDT list of records."
updated: 2024-03-21T16:49:50Z
published: 2024-03-21T16:49:50Z
canonical: "docs.zilliant.com/configure-search-bar-for-cdt"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zilliant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Search Bar for CDT

Define and configure a header-level **Search bar** for the CDT list of records.

## To define a Search Bar configuration

1. In the App Launcher, search for the **Search Bar Configurations** app, and select **New**.
2. In the **New Search Bar Configuration** dialog, enter information or make selections:
  - **Search Bar Configuration Name**—Enter a descriptive name for the configuration.
  - **Type of Search**—Enter the type of search operator this configuration should use, such as **Contains** or **Starts with**.
  - **sObject Name**—Enter the API name of the Salesforce object that contains the data you'll be searching through in this configuration. This should be the same name that you have specified in the [**New Data Table Configuration** dialog](/v1/docs/define-cdt-configuration).
  - Select **Save**.
3. Go to the **Product Selector Configuration > Related > Search Fields**, and select **New**.
4. In the **New Search Field** dialog, enter information or make selections:
  - **Name**—Enter the name of the search field.
  - **Column Label**—Enter a user-friendly label that will appear in the rendered **Search bar**.
  - **Field Name of Column (for SOQL query**)—Enter the API name of a field from the **sObjectName**. For example, **AccountNumber** for a standard Salesforce field, or **zpf__SLAExpirationDate__c** for a custom field.  

To check the exact value to specify in the **Field Name of Column (for SOQL query**) field:
    - Go to the **Object Manager**, and select the appropriate **sObject**.
    - Select **Fields & Relationships**, and check the **Field Name** column value. This is the name of the field to be used in the **Field Name of Column (for SOQL queries**).
    - Make sure that the field you choose is of type **Text**. Otherwise, you will get an error when creating the configuration.
    - You can add as many fields as you need.
  - Select **Save**.
5. Select the **Details** tab, and assign the default search field in the **Default Displayed Search Field**:
  - Select the pencil-shaped icon next to **Default Displayed Search Field**.
  - Enter the name of the field (it is the same name you have already entered in the **Related** tab, in the **Column Label** field). You can select **Show All Results...**.
  - From the dropdown, select the field you want to display as a default. The ALL option will be automatically available if there are more than two search fields configured for the Search bar. You can select ALL as a default search value.
  - Select **Save**.

## To add the Search Bar Configuration to the Configurable Data Table component

1. From the App Launcher, select **Data Table Configurations**, then select the configuration you defined.
2. From the **Search Bar Configuration** dropdown, select the configuration you defined.
3. Select **Save**.

![apps_60](https://cdn.document360.io/24f960e8-3c1c-4c18-a2c6-83b6ae4aab84/Images/Documentation/apps_60.png?sv=2026-02-06&spr=https&st=2026-11-04T19%3A08%3A29Z&se=2026-11-04T20%3A08%3A29Z&sr=c&sp=r&sig=6PQiUL4JKP%2FzlWbRodkNjqruVqvyQ6bO5gDXWzIZgpE%3D) App Launcher