---
title: "Configure entity visualization options"
slug: "configure-entity-visualization-options"
abstract: "How to visualize taxonomy properties in search results and customize search result templates."
---
# Configure entity visualization options

Sitecore Content Hub provides entity visualization options in **Search** components that use the taxonomy definitions associated with the entity. This feature adds visualization properties to all taxonomy definitions as well as some entity definitions, and extends the **Search** component output templates to reflect these changes. These visualization properties are used in the **Search** component output.

## Image, icon, and color

On the Image and icon tab for the select [view](https://doc.sitecore.com/ch/en/users/content-hub/views.html "Views"), you can assign an image, an icon and a color:

- to taxonomy items (from the [taxonomy management page](https://doc.sitecore.com/ch/en/users/content-hub/add-values-to-a-taxonomy.html "Add values to a taxonomy")).
- to specific entities (from the [entity detail page](https://doc.sitecore.com/ch/en/users/content-hub/edit-an-entity-details-page.html "Edit an entity details page")).

There is a rich set of icons that you can choose from. To find an icon, you can use keywords (for example, *car*). You can also select a color from the list of available colors.

> [!note]
> The **Theme color** option dynamically applies the main color selected for the user theme.

Visualization options for the image property are:

- *Thumbnail*
- *Icon*

### Thumbnail option

The *Thumbnail* option displays the thumbnail (master image) of the entity if it is available.

> [!note]
> If the Image property is set to *Thumbnail*, but there is no master image available for an entity, the *Icon* option is used instead.

### Icon option

The *Icon* option displays icons instead of thumbnails, as configured in the icon and color properties.

You can apply icons from a taxonomy relation or from the entity itself.

## Add icon field

You can add icon fields as indicators in the search output. After you select the relevant taxonomy definition, various display formats are available.

![Search component configuration add field display format options](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_configuration_add_field_display_format_optionspng.png)

Display formats include:

- *Badge* - this option displays the indicators as colorful badges on the entities.

    ![Search component badge output](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_badge_outputpng.png)

- *Relation* - this option displays the indicators as clickable links on the entities. Clicking on the link redirects the user to the configured detail page.

    ![Search component relation output](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_relation_outputpng.png)

- *Colored icon* - this option displays the indicators as colored icons.

    ![Search component colored icon output](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_colored_icon_outputpng.png)

- *Colored label* - this option displays the indicators as colored labels. The labels in the grid are the ones configured in the taxonomy item.

    ![Search component colored label output](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_colored_label_outputpng.png)

- *Colored icon and label* - this option displays the indicators as colored icons and labels. The labels in the grid are the ones configured in the taxonomy item.

    ![Search component colored icon and label output](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/search_component_colored_icon_and_label_outputpng.png)

> [!tip]
> To change the badge color, select a color from the drop-down list next to **Color**.

## Visualization when using non-taxonomy relations

A non-taxonomy relation doesn't display icon or label options because visualization relies on the *Entity.Visualization* property.

To create the *Entity.Visualization* property:

1. On the menu bar, click **Manage** :mdiCogOutline:.
2. On the **Manage** page, click **Schema**.
3. On the **Schema** page, select the definition to which you want to add the *Entity.Visualization* property, for example, *M.Asset*.
4. On the asset definition page, click **New member**.
5. In the **New member** dialog, next to **Property**, click **Select**.
6. In the data types drop-down list, select *JSON* and then click **Next**.
7. Make sure the **Allow updates** switch is turned on.
8. On the **General information** tab, in the **Name** field, enter `Entity.Visualization`.
9. Click **Save**.
10. Click **Apply changes**.

    If you navigate to an entity to which the *Entity.Visualization* member has been added and click **Edit** on the **Overview** pane, you will see the *Entity-Visualization* section.

    ![Asset shows the entity visualization](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/asset_shows_the_entity_visualizationpng.png)