<!--
{
  "availability" : [
    "macOS: 10.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Collaboration",
  "identifier" : "/documentation/Collaboration/CBIdentityPicker",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Collaboration"
    ],
    "preciseIdentifier" : "c:objc(cs)CBIdentityPicker"
  },
  "title" : "CBIdentityPicker"
}
-->

# CBIdentityPicker

A `CBIdentityPicker` object allows a user to select identities—for example, user or group objects—that it wants one or more services or shared resources to have access to. An identity picker can be displayed either as an application-modal dialog or as a sheet attached to a document window. An identity picker returns the selected records to be added to access control lists using Collaboration. If a selected record is not a user or group identity, then an identity picker prompts the user for additional information—such as a password—to promote that record to a sharing account.

```
class CBIdentityPicker
```

## Topics

### Running an Identity Picker

[`-  runModalForWindow:modalDelegate:didEndSelector:contextInfo:`](/documentation/Collaboration/CBIdentityPicker/runModal(for:modalDelegate:didEnd:contextInfo:))

Runs the receiver modally as a sheet attached to a specified window.

[`-  runModalForWindow:completionHandler:`](/documentation/Collaboration/CBIdentityPicker/runModal(for:completionHandler:))

Runs the identity picker modally as a sheet attached to a specified window.

[`-  runModal`](/documentation/Collaboration/CBIdentityPicker/runModal())

Runs the receiver as an application-modal dialog.

### Retrieving Identities

[`identities`](/documentation/Collaboration/CBIdentityPicker/identities)

The array of identities (represented by `CBIdentity` objects) selected using the identity picker.

### Setting and Getting Properties

[`title`](/documentation/Collaboration/CBIdentityPicker/title)

The title of the identity picker.

[`allowsMultipleSelection`](/documentation/Collaboration/CBIdentityPicker/allowsMultipleSelection)

A Boolean value indicating whether the user is allowed to select multiple identities.

## Relationships

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

### Conforms To

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Hashable`](/documentation/Swift/Hashable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)