---
title: "renameAccessory(_:options:completionHandler:)"
framework: accessorysetupkit
role: symbol
role_heading: Instance Method
path: "accessorysetupkit/asaccessorysession/renameaccessory(_:options:completionhandler:)"
---

# renameAccessory(_:options:completionHandler:)

Displays a view to rename an accessory.

## Declaration

```swift
func renameAccessory(_ accessory: ASAccessory, options renameOptions: ASAccessory.RenameOptions = [], completionHandler: @escaping @Sendable ((any Error)?) -> Void)
```

```swift
func renameAccessory(_ accessory: ASAccessory, options renameOptions: ASAccessory.RenameOptions = []) async throws
```

## Parameters

- `accessory`: The accessory to rename.
- `renameOptions`: Options that affect the behavior of the rename operation.
- `completionHandler`: A block or closure that executes after the rename operation completes. The completion handler receives an doc://com.apple.documentation/documentation/Foundation/NSError instance if the rename operation encounters an error.

## Discussion

Discussion To rename a Wi-Fi SSID with this method, use the option ssid.

## See Also

### Managing accessories

- [ASAccessory.RenameOptions](accessorysetupkit/asaccessory/renameoptions.md)
- [removeAccessory(_:completionHandler:)](accessorysetupkit/asaccessorysession/removeaccessory(_:completionhandler:).md)