---
title: FaceGroupAnalyzer.Entity
framework: Media Intelligence
role: symbol
role_heading: Structure
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+]
path: mediaintelligence/facegroupanalyzer/entity
---

# FaceGroupAnalyzer.Entity

A cluster of faces that belong to the same person.

## Declaration

```swift
struct Entity
```

## Overview

Overview This type represents a distinct person as identified by the framework’s clustering algorithm. After you call update(subprogress:), each detected face receives a entityID that associates it with an entity. Use fetchFaces(for:) to retrieve all faces that belong to a particular entity, or fetchAssetIDs(for:) to find the images in which a person appears.

## Topics

### Identifying an entity

- [id](mediaintelligence/facegroupanalyzer/entity/id-swift.property.md)
- [FaceGroupAnalyzer.Entity.ID](mediaintelligence/facegroupanalyzer/entity/id-swift.struct.md)

## Relationships

### Conforms To

- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Retrieving faces and entities

- [allFaces](mediaintelligence/facegroupanalyzer/allfaces.md)
- [allFacesByEntityID](mediaintelligence/facegroupanalyzer/allfacesbyentityid.md)
- [allEntities](mediaintelligence/facegroupanalyzer/allentities.md)
- [allAssetIDs](mediaintelligence/facegroupanalyzer/allassetids.md)
- [allAssetIDsByEntityID](mediaintelligence/facegroupanalyzer/allassetidsbyentityid.md)
- [FaceGroupAnalyzer.Face](mediaintelligence/facegroupanalyzer/face.md)