---
title: "identify(completionHandler:)"
framework: homekit
role: symbol
role_heading: Instance Method
path: "homekit/hmaccessory/identify(completionhandler:)"
---

# identify(completionHandler:)

Asks an accessory to identify itself.

## Declaration

```swift
func identify(completionHandler completion: @escaping @Sendable ((any Error)?) -> Void)
```

```swift
func identify() async throws
```

## Parameters

- `completion`: Block that is invoked once the request is processed.

## Discussion

Discussion Accessories typically identify themselves by briefly doing something the user can see or hear. The behavior is specific to the device. For example, a light bulb might identify itself by briefly turning on if it is currently off, or by briefly dimming if it is currently on. This can help a user pinpoint one device among several that are similar.

## See Also

### Asking an accessory to identify itself

- [supportsIdentify](homekit/hmaccessory/supportsidentify.md)