Manage entities
Use the Entity Search feature to find specific people in your videos by creating entities that represent the people you want to find, then using those entities in your search queries.
Each entity represents one person and belongs to an entity collection. Every entity requires at least five image assets to accurately identify the person.
Note
Users on the Free plan can create one entity collection with up to fifteen entities. To create more collections or entities, upgrade to the Developer plan. For upgrade instructions, see Upgrade your plan.
Typical workflow
Follow these steps to use entity search:
- Create an entity collection.
- Add entities to the collection.
- Upload images for each entity.
- Search using your entities.
Set up your first entity and entity collection
Complete these steps to create your first entity and entity collection:
- From the sidebar, choose Entities.
- Select the Create Entity Collection button.
- Enter a name and description for your collection.
- Enter a name for your first entity.
- Upload at least five images that represent the person you want to identify.
- Select the Create button.
User interface
After you complete the initial setup, the Entities page displays the elements below:
- Create entity collection: Creates a new entity collection.
- Entity collections: A list showing all collections in your account with the following information:
- Collection thumbnail (first asset from the first entity)
- Number of entities in the collection
- Collection name
- Creation date
- The three dots menu to edit, rename, or copy the collection identifier
- An Add entity button for the collection
- Sort by: Sorts collections by creation date, last updated date, or name.
- Filter: Searches for specific entity collections
Search using entities
After you create entities, you can use them to find specific people in your videos:
- Go to the Search page.
- Include your entity in your search query using one of these methods:
- Type
@
followed by the name of the entity that you want to find. - Select the Entity Search button and choose your entity from the list.
- Type