<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/IntentParameter-Person",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "People"
}
-->

# People

Configure the details for parameter variables that contain references to people.

## Topics

### Creating an intent parameter

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:requestValueDialog:inputConnectionBehavior:))

Creates an app intent parameter.

[`convenience init<OptionsProvider>(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, optionsProvider: OptionsProvider)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:requestValueDialog:inputConnectionBehavior:optionsProvider:))

Creates an app intent parameter with a list of selectable options.

[`convenience init<Spec, OptionsProvider>(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, optionsProvider: OptionsProvider, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:requestValueDialog:inputConnectionBehavior:optionsProvider:resolvers:))

Creates an app intent parameter with a list of selectable options that can convert the selected value.

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, requestValueDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:requestValueDialog:inputConnectionBehavior:resolvers:))

Creates an app intent parameter that can convert the selected value.

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, size: [IntentWidgetFamily : IntentCollectionSize], inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:size:inputConnectionBehavior:)-1i2sn)

Creates an app intent parameter for an array with a specified size per widget family.

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, mode: IntentPerson.ParameterMode, size: IntentCollectionSize, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:mode:size:inputConnectionBehavior:)-6efsz)

Creates an app intent parameter for an array with a specified size.

### Accessing the parameter mode

[`var parameterMode: IntentPerson.ParameterMode?`](/documentation/AppIntents/IntentParameter/parameterMode)

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

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


---

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)