# Identify Face

> `UiPath.AmazonRekognition.Activities.AddFace`

`UiPath.AmazonRekognition.Activities.AddFace`

The **Identify Face** activity uses the Amazon Rekognition [SearchFacesByImage](https://docs.aws.amazon.com/rekognition/latest/dg/API_SearchFacesByImage.html) API to first detect the largest face in your input image (**ImagePath** or **ImageURL**), then search the specified collection (**Collection**) for matching faces. The activity compares the features of the input face with the faces in the collection and outputs an array of faces (**Faces**) that match your input image.

## Summary

### Dependencies

| Dependency | Details |
| --- | --- |
| Packages | UiPath.Amazon.Rekognition.Activities |
| Activities | [Amazon Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-rekognition-amazon-scope#amazon-scope)  [Create Collection](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-rekognition-create-collection#create-collection) (unless a collection already exists)  [Add Face](https://docs.uipath.com/activities/other/latest/legacy-integrations/amazon-rekognition-add-faces#add-face) (unless the collection already contains the faces you want to identify) |

### Attributes

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attribute  
     Details  
  
 
 
  
     Input Datatypes (Variables)  
    <code>String</code> Applies to property: ImagePath , ImageURL , and CollectionName 
  
  
     Output Datatypes (Variables)  
    <code>Faces[]</code>
      
         Applies to property: Faces 
         For more information, see the Face datatype in the Amazon Rekognition API documentation. 
      

  
  
     API used  
     Amazon Rekognition - SearchFacesByImage 
  
  
     Examples  
    Quickstart 
  
 

## Properties

The values for the following properties are specified when adding this activity to your project in UiPath Studio.

![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-34479-a0b2255e-b9ca6ecc.webp)

### Common

#### DisplayName

The display name of the activity.

| Attributes | Details |
| --- | --- |
| **Type** | `String` |
| **Required** | Yes |
| **Default value** | *Identify Face* |
| **Allowed values** | Enter a `String` or `String` variable. |
| **Notes** | N/A |

### Input

#### CollectionName

The name or ID of an existing collection that you want to use to identify detected faces.

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attributes  
     Details  
  
 
 
  
    Type 
    <code>String</code> 
  
  
    Required 
     Yes  
  
  
    Default value 
     Empty  
  
  
    Allowed values 
    Enter a <code>String</code> or <code>String</code> variable. 
  
  
    Notes 
   
      
         If you have an existing collection that you want to use, enter its exact collection name. 
         There is not an activity to retrieve a list of your collection names, but you can call the ListCollections API directly using the AWS CLI or AWS SDK API. 
      

  
 

#### ImagePath

The path to a local image that you want to analyze.

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attributes  
     Details  
  
 
 
  
    Type 
    <code>String</code> 
  
  
    Required 
     Yes (if the ImageURL is empty)  
  
  
    Default value 
     Empty  
  
  
    Allowed values 
    Enter a <code>String</code> or <code>String</code> variable. 
  
  
    Notes 
   
      
         Either the ImagePath or ImageURL property is required. 
         If you enter values for both the ImagePath and ImageURL , the Image Path value is used. 
      

  
 

#### ImageURL

The URL of an image that you want to analyze.

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attributes  
     Details  
  
 
 
  
    Type 
    <code>String</code> 
  
  
    Required 
     Yes (if the ImagePath is empty)  
  
  
    Default value 
     Empty  
  
  
    Allowed values 
    Enter a <code>String</code> or <code>String</code> variable. 
  
  
    Notes 
   
      
         Either the ImagePath or ImageURL property is required. 
         If you enter values for both the ImagePath and ImageURL , the Image Path value is used. 
      

  
 

### Misc

#### Private

If selected, the values of variables and arguments are no longer logged at Verbose level.

| Attributes | Details |
| --- | --- |
| **Type** | Checkbox |
| **Required** | No |
| **Default value** | Not Selected |
| **Allowed values** | Selected or Not Selected |
| **Notes** | N/A |

### Options

#### Confidence

The minimum confidence value (i.e., percentage of similarity) to consider the faces to be a match.

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attributes  
     Details  
  
 
 
  
    Type 
    <code>Double</code> 
  
  
    Required 
     No  
  
  
    Default value 
    0.70 (not displayed in the property)  
  
  
    Allowed values 
     Enter a number between 0 and 1 to indicate the percentage of similarity (e.g., enter .8 if you want the similarity to be 80%).  
  
  
    Notes 
   
      
         If this property is set, the Faces property only returns the faces that meet or exceed the specified value 
         Example: If you enter a value of .8 , the faces in the ImagePath or ImageURL image are considered identified to the faces in the Collection if the activity returns a confidence level of .8 or greater. If the activity returns a confidence level less than .8, the faces are not considered identified and the Faces property returns a null value. 
      

  
 

#### MaxResults

The maximum number of faces that you want the activity to return in the response.

| Attributes | Details |
| --- | --- |
| **Type** | `Int32` |
| **Required** | No |
| **Default value** | Empty |
| **Allowed values** | Enter a `Int32` or `Int32` variable. |
| **Notes** | N/A |

### Output

#### Faces

An array of faces that match the face specified in the input image.

 <colgroup>
  <col/>
  <col/>
 </colgroup>
 
  
     Attributes  
     Details  
  
 
 
  
    Type 
    <code>Face[]</code>UiPath.Amazon.Rekognition.Models.Face[] 
  
  
    Required 
     No (recommended if you plan to use the output data in subsequent activities)  
  
  
    Default value 
     Empty  
  
  
    Allowed values 
    Enter your value as a <code>Face[]</code> variable. 
  
  
    Notes 
   
      
         If the Confidence value is set, the array only includes the faces that meet or exceed the specified level of similarity. 
         If you plan to use the For Each activity to process the array output, select UiPath.Amazon.Rekognition.Models.Face as the TypeArgument.