> ## Documentation Index > This page is part of the Cloudinary Assets product. Fetch the complete documentation index for Cloudinary Assets at: https://cloudinary.com/documentation/llms-cloudinary-assets.txt?referrer=docpage and then use it to discover all relevant pages before exploring further. > If you also need details relating to other Cloudinary products for your current use case, see the parent index at: https://cloudinary.com/documentation/llms.txt?referrer=docpage # People Search Cloudinary’s AI-powered **People Search** automatically recognizes and groups individuals across your image library using advanced facial recognition technology. It understands visual identity rather than relying on filenames or metadata, letting you find, review, and manage people in your media at scale. Through its intuitive visual interface, People Search makes it easy to explore detected faces, view all images associated with a person, and update names and details to improve recognition accuracy and organization. > **READING**: > > :no-title > **Assets Enterprise plans:** > * The **People Search** feature is a premium offering for **Assets Enterprise**, with availability depending on your account setup. If People Search isn't yet enabled for your account and you'd like to use it, contact your Customer Success Manager. > **Assets Free plan:** > * This feature isn’t included in the Media Library available with the **Assets Free** plan, which offers basic management. It's part of the Media Library for **Assets Enterprise** plans. > * To learn more about the features available in the **Assets Free** plan and how they can support development workflows, see [Media Library for Developers](media_library_for_developers). > * For upgrade options or more information, [contact us](https://cloudinary.com/contact). ![People Search - further filter images found for a person](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761492029/docs/DAM/people_search_images_filtered.png "thumb: w_800,dpr_2, width:800, popup:true") ## Overview The **People Search** feature combines AI precision with flexible management tools, available both in the Cloudinary Console (Assets product) and through the People Search API. It gives you complete control over how to display, label, and maintain identified individuals across your assets. With People Search, you can: * **Manage people**: * **View and explore detected people**: Access all detected people, each represented by a thumbnail taken from one of their associated images. * **Search and filter efficiently**: Find people by name or status (named, unnamed, or all) to focus on labeled individuals or identify unnamed clusters for review. * **Manage person details**: Assign or update a person's name to keep your collections well-organized. * **Manage a person's images**: * **Preview linked assets**: Access all images associated with each detected person. * **Select a person's cover image**: Choose which image to use as the cover thumbnail for that person. Whether through the Cloudinary Console or the People Search API, you can maintain clean, searchable collections of identified individuals, enhancing media organization and streamlining facial-recognition–based workflows. ## In the Cloudinary Console (Assets product) The **People Search** feature in the Assets product provides a visual interface for viewing and managing all people automatically detected in your assets using Cloudinary's facial recognition technology. **To navigate to the People Search:** 1. Select the Assets product from the Product Navigation menu. 2. Select the **People** option. The People Search displays a gallery of detected individuals that you can view, manage, and find images for. ![People Search - main view](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761491738/docs/DAM/people_search_main_view.png "thumb: w_800,dpr_2, width:800, popup:true") ### Manage people You can manage all detected people by assigning or editing their names and choosing to hide or show individuals in the gallery. Use search and filter tools to find easily the people you're looking for. #### Find people You can view all detected people in the People Search gallery and quickly locate specific individuals. Scroll through the list to find someone manually, or use the available search and filter tools to narrow results. You can: * Sort by name, date added, or date last updated. * Filter the list to show all, named, unnamed, or hidden people. * Search using free text to quickly find a person by name. ![People Search - filter](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761492003/docs/DAM/people_search_filter.png "thumb: w_500,dpr_2, width:500, popup:true") #### Assign or edit names to identified people You can assign each detected person a name to make searches easier and improve recognition consistency. When assigning a name, that name is immediately applied across all assets associated with that detected person. **To edit a person's name**, use the context menu on their card. ![People Search - name and hide](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761491990/docs/DAM/people_search_name_hide.png "thumb: w_300,dpr_2, width:300, popup:true") #### Hide or show a person You can choose to hide a person to temporarily remove them from the visible gallery without deleting their data. This can be useful for internal review, quality control, or when certain detected clusters aren't relevant to your workflow. **To hide a person:** 1. Open the context menu on the person's card. 2. Click **Hide**. **To show a hidden person:** 1. Select **Hidden** in the **Show** filter. 2. Open the context menu on the person's card. 3. Click **Unide**. **To hide or show multiple people:** 1. If you want to show hidden people, select **Hidden** in the **Show** filter. 1. Select the people you want to show or hide. 2. In the assets toolbar, click **Hide** or **Unhide**. Bulk hide Bulk unhide ### Manage a person's images You can find and manage all images where a detected person appears. From this view, you can browse, refine results, or select a new cover image for the person. #### View a person's images You can view all the images where a selected person appears. **To find a person's images:** 1. Find a person by scrolling through the gallery or by ordering, filtering, or searching by name. 2. Double click the thumbnail that belongs to the desired person. ![People Search - find images for a person](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761492018/docs/DAM/people_search_images.png "thumb: w_800,dpr_2, width:800, popup:true") #### Filter a person's images While viewing the images associated with a person, you can use free text search or any of the available filters to narrow the displayed results. This helps you focus on specific image sets related to that person. ![People Search - further filter images found for a person](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/v1761492029/docs/DAM/people_search_images_filtered.png "thumb: w_800,dpr_2, width:800, popup:true") #### Select a cover image While viewing the images associated with a person, you can select which one to use as their cover image in the gallery. The thumbnail is automatically generated by extracting the face region from the selected image using a bounding box around the detected face. **To change the cover image:** 1. Open the context menu on the person's card. 2. Click **Set as cover image**. ![People Search - further filter images found for a person](https://cloudinary-res.cloudinary.com/image/upload/f_auto/q_auto/bo_1px_solid_grey/docs/DAM/people_search_select_cover.png "thumb: w_800,dpr_2, width:800, popup:true") ## Using the People Search API The People Search API is part of the [Admin API](admin_api) and enables you to retrieve and manage people-related data detected through Cloudinary's facial recognition features. It lets you work with clusters of identified individuals and their associated images, helping you organize, label, and refine your collections programmatically. For the full endpoint reference, including request parameters, examples, and sample responses, see the [people section of the Admin API reference](admin_api#people). ## Limitations * **Detection availability**: People Search only includes assets uploaded after the feature was enabled for your account. * **Associations**: The interface currently supports naming and browsing detected people, but it doesn't yet allow confirming or reassigning asset associations.