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:

  1. Create an entity collection.
  2. Add entities to the collection.
  3. Upload images for each entity.
  4. Search using your entities.

Set up your first entity and entity collection

Complete these steps to create your first entity and entity collection:

  1. From the sidebar, choose Entities.
  2. Select the Create Entity Collection button.
  3. Enter a name and description for your collection.
  4. Enter a name for your first entity.
  5. Upload at least five images that represent the person you want to identify.
  6. Select the Create button.

User interface

After you complete the initial setup, the Entities page displays the elements below:

  1. Create entity collection: Creates a new entity collection.
  2. 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
  1. Sort by: Sorts collections by creation date, last updated date, or name.
  2. Filter: Searches for specific entity collections

Search using entities

After you create entities, you can use them to find specific people in your videos:

  1. Go to the Search page.
  2. 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.