---
title: "Configure visual search manually"
slug: "configure-visual-search-manually"
abstract: "How to manually configure visual search if you have modified your default media processing flows or preview rendition names for images or vectors."
---
# Configure visual search manually

You need to manually configure visual search if you have modified the default media processing flows or preview rendition names for images or vectors, or if the following message displays when you enable visual search - *The media matrix with identifier 'M.MediaMatrix.Content' has been modified. Manual configuration is required*.

> [!note]
> The preview rendition name must remain *preview* (lowercase).

Before you begin:

- On the Assets page, [modify the **Search** component](https://doc.sitecore.com/ch/en/users/content-hub/display-similar-assets-on-the-assets-page.html "Display similar assets on the Assets page") to add a **View similar assets** operation and also add a **Selection** component
- On the Assets details page, [modify the **Entity operations** component](https://doc.sitecore.com/ch/en/users/content-hub/display-similar-assets-on-the-asset-details-page.html "Display similar assets on the Asset details page") and add a **Search** component. Then, [add a Container component](https://doc.sitecore.com/ch/en/users/content-hub/configure-visual-search-manually.html#UUID-6693b8f4-5c1a-2e0e-5c73-bdabc0ffe085_section-id235637567356452 "Add a Container component").

This walkthrough explains how to:

1. [Add a container component to the asset details page](https://doc.sitecore.com/ch/en/users/content-hub/configure-visual-search-manually.html#UUID-6693b8f4-5c1a-2e0e-5c73-bdabc0ffe085_section-id235637567356452 "Add a Container component")
2. [Configure media processing for images and vectors](https://doc.sitecore.com/ch/en/users/content-hub/configure-visual-search-manually.html#UUID-6693b8f4-5c1a-2e0e-5c73-bdabc0ffe085_N1781875680666 "Configure media processing for images and vectors")

> [!note]
> To verify your visual search implementation, upload a file with an extension for which you configured embeddings and verify that a new embeddings rendition is visible using the [Entities API](https://api-docs.sitecore.com/ch/entities-api/entities/entitybyid) (`/api/entities/<ASSET_ID>`).

## Add a Container component

After you have [modified the Entity operations component and the Search component](https://doc.sitecore.com/ch/en/users/content-hub/display-similar-assets-on-the-asset-details-page.html "Display similar assets on the Asset details page") on the Asset details page, add a container component.

To add a container component:

1. On the **Asset details** page, on the **Layout** tab, in the **Main zone**, click :mdiPlus: **Component**.
2. In the **Add component** dialog, click the **Container** component to select it and then click **Add**.
3. In the **Component settings** dialog, in the **Title** field, type *Similar assets*.
4. Turn on the **Visible** switch and, from the **UI visibility** drop-down list, click **Always** and then click **Save**.
5. Click **Save**.

    ![visual-search-add-a-container.png](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/visual-search-add-a-container.png)

6. On the Similar assets container component, click **Actions** :mdiDotsHorizontal: > **Settings**.
7. On the **General** tab, from the **Container** drop-down list, click **Panel** and then click **Save**.
8. Click *Similar assets* to open the details page and add a **Search** component and then click the component to open its details page.
9. On the **Search component** details page, in the left pane, click **Filters** and, in the right pane, on the **System** tab, from the **Filter type** drop-down list click **Definition** and then select the **Asset (M.Asset)** definition.
10. Click the **Fixed** tab and add a fixed filter with the following settings:
    - **Input type** - Page entity
    - **Filter type** - Similar images
11. Click **Save**.
12. In the left pane, click **Functionality**, turn off all switches.
13. In the left pane, in the **Tools** section, turn on the **Paging** switch and, in the right pane, change all values to 3 and then **Save and Close**.

## Configure media processing for images and vectors

For each images or vectors media flow in the Content set, configure an *Embeddings* task as a child of the **Extract preview** task. Embeddings will be created based on the preview rendition. You can also create a new rendition specifically for the embeddings calculation if needed

> [!note]
> To use visual search, you must have a *preview* rendition.

To configure media processing:

1. On the menu bar, click **Manage** :mdiCogOutline:.
2. On the **Manage** page, click **Media processing**.
3. On the **Media processing** page, in the left pane, click **Content**.
4. In the right pane, click the media processing flow used by your visual search configuration to open it.
5. For each relevant flow (images and vectors), on the **preview** rendition, click :mdiPlusCircle:, in the **Add task** pane, click **Extract image embeddings** to add the task as a child of the **preview** task.

    ![media matrix showing the embeddings task as a child task to the preview task](https://doc.sitecore.com/api/markdown-image/ch/en/users/content-hub/images/adding-an-embedding-task.png)

6. Click **Save** to accept all default values and then click **Close**.
7. On the **Media processing** page for **Content**, click **Publish**.
8. Click **Publish** again to confirm you want to publish your changes.