---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/flex/admin-guide/setup/unified-profiles/setup/configure-ui/header-search#article
headline: Configure customer header and search (Public Beta)
description: Configure the customer header and profile search in Flex to control what agents see at a glance and which identifiers agents can search by.
url: https://www.twilio.com/docs/flex/admin-guide/setup/unified-profiles/setup/configure-ui/header-search
inLanguage: en
dateModified: 2026-07-17T03:41:20.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Configure customer header and search (Public Beta)

> \[!IMPORTANT]
>
> Unified Profiles in Flex is currently available as a Public Beta product and the information contained in this document is subject to change. This means that some features are not yet implemented and others may be changed before the product is declared as Generally Available. Public Beta products are not covered by a Twilio SLA.

> \[!WARNING]
>
> Unified Profiles in Flex is not a HIPAA Eligible Service or PCI compliant and should not be used in Flex or Segment workflows that are subject to HIPAA or PCI.

The customer header and search component determines how the customer header appears to agents and how agents can search.

By default, the customer header and search component is turned off because the customer details and customer history components are turned off by default. When you turn on one or both of those components, the customer header and search component is automatically turned on as well.

Before configuring these settings, ensure that you have already configured [identifiers](/docs/flex/admin-guide/setup/unified-profiles/identifiers) and [traits](/docs/unified-profiles/traits).

> \[!WARNING]
>
> The customer header and profile search settings are read-only for Flex UI versions prior to 2.8.0.

## Customer header

The customer header displays key customer information to your agents, including the customer's name and how long they've been a customer.

When enabled, this information appears to agents at the top of the section that includes the [Details and History tabs](/docs/flex/end-user-guide/copilot/customerprofiles):

![Flex UI with Ana Smith's profile highlighted, showing customer history and incoming call details.](https://docs-resources.prod.twilio.com/761052f3fcb95550357519bff7e5e654daee02253a271fd9dcee312571f01c00.png)

The customer header displays the following field names:

* **Customer name**
* **Secondary trait**
* **Customer image or avatar**

You can map these field names to your [traits](/docs/unified-profiles/traits) in Unified Profiles. For example:

| **Field name**           | **Trait**                |
| ------------------------ | ------------------------ |
| Customer name            | `First name` `Last name` |
| Secondary trait          | `Customer since`         |
| Customer image or avatar | `Profile image`          |

## Profile search

### Manual search options

Agents can manually search for a profile if the automated Unified Profiles search doesn't find a profile.

To configure which identifiers agents can use in their search:

1. From the Twilio Console, navigate to **Flex** > **Contact center settings** > **UI components** > **Customer header and search**.
2. Select the [Profile search](https://console.twilio.com/us1/develop/flex/settings/ui-components/customer-header/search) tab.
3. Choose to allow all identifiers for manual search, or limit the search to identifiers that make sense for your use case. For example, you might remove CRM IDs if they are unlikely to be relevant for your agents.

You can manage the identifier display name in [Console](https://console.twilio.com/us1/develop/unified-profiles/manage/identifiers) and add or remove identifiers in Segment.

If you don't see the identifiers you want, or if manual search doesn't work as expected, check your [customer profile identifier settings and mappings](/docs/flex/admin-guide/setup/unified-profiles/identifiers).

### Unidentified profiles

When someone reaches out to your contact center and can't be matched to a profile in your Segment space, an "unidentified profile" is automatically created in your Segment space.

Unidentified profiles are profiles that are not enhanced with data from your CRM or data warehouse and contain only the data added by Unified Profiles. A profile is considered unidentified if the `user_id` property isn't defined.

To display unidentified profiles to agents, navigate to the **Profile search** tab and check **Show unidentified profiles to agents**. If you uncheck this box, unidentified profiles will not appear in search results.

In the **Profile search** tab, you can also add a badge label for unidentified profiles, which Flex displays to agents in the customer header.

> \[!NOTE]
>
> Configure these settings in [Agent Copilot](/docs/flex/admin-guide/setup/copilot).