# Detect faces

> `UiPath.MicrosoftFace.Activities.DetectFaces`

`UiPath.MicrosoftFace.Activities.DetectFaces`

Detects faces inside the specified image and specifies characteristics like the estimated age of the person or if they wear any glasses.

## 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

* **ImagePath** - The path to the image to be sent for analyses. This field is mutually exclusive with the **ImageURL** field.
* **ImageURL** - The URL to the image to be sent for analyses. This field is mutually exclusive with the **ImagePath** field.

### Misc

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

### Output

* **Faces** - A collection of the identified faces return as a Custom Class array.
```
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;
}
```
