# Identify faces

> Properties and configuration for the Identify Faces activity, which finds the closest matching persons for faces in a specified person group.

`UiPath.MicrosoftFace.Activities.DetectFaces`

Finds the closest match persons for the provided faces inside the specified person group.

## Properties

### Authentication

* **ServiceURL** - The endpoint to the Microsoft Face service. Format is `https://*region*.api.cognitive.microsoft.com`.
* **SubscriptionKey** - The subscription key for authenticating the Microsoft Face Service calls. The subscription key needs to be provided by Microsoft. For more information please visit the official Microsoft documentation [here](https://azure.microsoft.com/en-us/pricing/details/cognitive-services/face-api/)

### Common

* **DisplayName** - The display name of the activity.

### Input

* **Faces** - A collection of faces. The faces need to be returned by a ] Activity. Each of the faces are identified independently.
* **PersonGroupName** - The name of the person group container in which the query will be carried out.

### Options

* **Confidence** - Customised identification threshold. The range for the threshold is in the range of [0,1]. Advanced users can tweak to overwrite the internal threshold for better precision on the specific use cases data.

### Misc

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

### Output

* **Persons** - The identified candidate person for each face query.
```
UiPath.MicrosoftFace.Face:
{
      string FaceId;
      FaceRectangle FaceRectangle;
      FaceAttributes FaceAtributes;
}
UiPath.MicrosoftFace.FaceAttributes:
{
      double Age;
      string Gender;
      string Glasses;
      double Smile;
}
UiPath.MicrosoftFace.FaceRectangle:
{
      Int Height;
      Int Left;
      Int Top;
      Int Width;
}
UiPath.MicrosoftFace.Person:
{
      double Confidence;
      string FaceId;
      string PersonId;
      string PersonName;
}
```