<!--
{
  "availability" : [
    "iOS: 16.0.0 -",
    "iPadOS: 16.0.0 -",
    "macCatalyst: -",
    "macOS: 13.0.0 -",
    "tvOS: 16.0.0 -",
    "visionOS: -",
    "watchOS: 9.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/IntentPerson",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "App Intents"
    ],
    "preciseIdentifier" : "s:10AppIntents12IntentPersonV"
  },
  "title" : "IntentPerson"
}
-->

# IntentPerson

Information that identifies a person participating in an intents-based interaction.

```
struct IntentPerson
```

## Topics

### Creating a contact

[`init(identifier: IntentPerson.Identifier, name: IntentPerson.Name, handle: IntentPerson.Handle?, aliases: [IntentPerson.Handle], isMe: Bool, image: DisplayRepresentation.Image?)`](/documentation/AppIntents/IntentPerson/init(identifier:name:handle:aliases:isMe:image:))

### Getting the person’s name

[`var name: IntentPerson.Name`](/documentation/AppIntents/IntentPerson/name-swift.property)

The name of this `IntentPerson`

[`enum Name`](/documentation/AppIntents/IntentPerson/Name-swift.enum)

A type that stores name-related information for a person.

### Getting identifying information

[`var handle: IntentPerson.Handle?`](/documentation/AppIntents/IntentPerson/handle-swift.property)

The primary `Handle` used to contact this `IntentPerson`

[`var aliases: [IntentPerson.Handle]`](/documentation/AppIntents/IntentPerson/aliases)

Other secondary `Handle`s used to contact this `IntentPerson`, if any

[`var isMe: Bool`](/documentation/AppIntents/IntentPerson/isMe)

Whether this `IntentPerson` represents the owner of the device

[`var image: DisplayRepresentation.Image?`](/documentation/AppIntents/IntentPerson/image)

An image representing this `IntentPerson`

[`struct Handle`](/documentation/AppIntents/IntentPerson/Handle-swift.struct)

A type that describes a single way to contact a person.

[`enum ParameterMode`](/documentation/AppIntents/IntentPerson/ParameterMode)

The type of interface to show when someone chooses a parameter that contains information about a person.

### Getting person-related identifiers

[`var identifier: IntentPerson.Identifier`](/documentation/AppIntents/IntentPerson/identifier-swift.property)

[`enum Identifier`](/documentation/AppIntents/IntentPerson/Identifier-swift.enum)

A type that manages a unique identifier for a person.

### Initializers

[`init(handle: IntentPerson.Handle)`](/documentation/AppIntents/IntentPerson/init(handle:))

Initializes an `IntentPerson` from a raw handle, like a phone number or an email address.
Use this initializer when the value is not linked to a known contact.

### Type Aliases

[`typealias Specification`](/documentation/AppIntents/IntentPerson/Specification)

[`typealias UnwrappedType`](/documentation/AppIntents/IntentPerson/UnwrappedType)

[`typealias ValueType`](/documentation/AppIntents/IntentPerson/ValueType)

### Type Properties

[`static var defaultResolverSpecification: EmptyResolverSpecification<IntentPerson>`](/documentation/AppIntents/IntentPerson/defaultResolverSpecification)

### Default Implementations

[Transferable Implementations](/documentation/AppIntents/IntentPerson/Transferable-Implementations)

## Relationships

### Conforms To

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

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

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

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

[`Transferable`](/documentation/CoreTransferable/Transferable)

[`DisplayRepresentable`](/documentation/AppIntents/DisplayRepresentable)

[`IntentValueExpressing`](/documentation/AppIntents/IntentValueExpressing)

[`CustomLocalizedStringResourceConvertible`](/documentation/Foundation/CustomLocalizedStringResourceConvertible)

[`InstanceDisplayRepresentable`](/documentation/AppIntents/InstanceDisplayRepresentable)

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

[`IntentValueConvertible`](/documentation/AppIntents/IntentValueConvertible)

[`TypeDisplayRepresentable`](/documentation/AppIntents/TypeDisplayRepresentable)

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

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

---

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)