---
title: Facial recognition
slug: content-marketing-platform/docs/facial-recognition
docTags: 
createdAt: 2026-10-14T00:00:00.000Z
---

Facial recognition detects faces in images you upload to the Library in Optimizely Content Marketing Platform (CMP). Label faces to identify people and see which images include them. This helps you find and manage people across your library without opening each asset.

## Before you begin

Facial recognition is off by default. An administrator must turn it on. CMP detects faces only in images uploaded after you enable the feature.

## Turn on facial recognition

Only administrators can turn facial recognition on or off. To turn it on:

1. Go to **Settings** > **Asset Management**.
2. In the **Face Recognition** section, select **Enable Face Recognition**.

![Screenshot of the Asset Management settings page where Enable Face Recognition is selected](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Xf6e2ARH3e4rKf69UCBbB_enable-facial-recognition.png)

When facial recognition is enabled, CMP automatically detects faces in images you upload.

## Label faces from the Face Detection page

The **Face Detection** page lists detected faces in the **Named People** and **Unnamed People** tabs. A green box marks each face. CMP labels each face *Unlabeled* followed by a number until you name it.

To label a face:

1. In the Library, select **Face Detection** in the toolbar.

![Screenshot of the Face Detection icon in the Library toolbar](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/yQuVUqvIb9r_Efqgi8RMA_select-face-detection.png)

2. Select the **Unnamed People** tab.
3. Enter a name in the text field below a face.

![Screenshot of the Unnamed People tab where a name is entered below a detected face](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Bdnh-aMNJ6WP_6OHR_zyh_unnamed-tab-enter-name.png)

4. Select the images that display the same person in the **More appearances of NAME** window. You can choose multiple images.
5. Click **Rename**.

![Screenshot of the More appearances window where one image is selected and the Rename button is highlighted](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/SjClEGaro92PbtmVlVI_h_click-rename.png)

CMP applies the name to each selected image and moves the face to the **Named People** tab.

![Screenshot of the Named People tab where a labeled person is highlighted](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/buq47MaH1z-5ZL10aF4-o_named-people-tab.png)

CMP recognizes any image you upload of the same person:

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/zzrTdMZ4l6yoKur3ZcfFB_facial-recognition-zendaya.png" size="50" alt="Facial recognition example showing Zendaya" isUploading="false" width="579" height="1465" darkWidth="579" darkHeight="1465" showCaption="false"}

## Label faces in an asset

Label faces directly in an asset by completing the following steps:

1. Open an asset and select **Show Faces** on the image. CMP marks each detected face with its name or **Add name**.
2. Select **Add name** on a face, or expand the **Facial Recognition** section and click **Add name** to enter a name.
3. Select **Hide Faces** to hide the face markers.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/3cFg1ptVBOhCnZGHRI9m7_add-name-by-showing-faces.png" size="50" alt="Screenshot of an image where Show Faces is turned on and the Facial Recognition section lists named and unnamed faces" isUploading="false" width="569" height="1155" darkWidth="569" darkHeight="1155" showCaption="false"}

### Rename or remove a name

Users with permission to manage facial recognition tags can rename or remove a name after it has been assigned in the following places:

- In the **Face Detection** page:
  - Select the name field for a detected person.
  - Enter a new name or click the delete icon to delete it.

![Screenshot showing rename or remove options in the Face Detection page](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/H1ZXh1CmwFRoak1VrBDbn_rename-asset.png)

- In the **Facial Recognition** section of an asset:
  - Click the edit icon next to the name.
  - Enter a new name or click the delete icon to delete it.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/qG-SrLxduUObdyiM-w2JF_rename-assets-from-side-panel.png" size="50" alt="Screenshot showing rename or remove options in the Facial Recognition section of an asset" isUploading="false" width="585" height="1144" darkWidth="585" darkHeight="1144" showCaption="false"}

- Enable **Show Faces** and click a face to rename or remove the name.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/UwFYdJjpJVSvQeZ2ZKx42_name-face.png" size="50" alt="Screenshot showing name editing for a detected face in the asset view" isUploading="false" width="557" height="620" darkWidth="557" darkHeight="620" showCaption="false"}