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

# App entities

Configure the details for parameter variables that contain custom app entities.

## Topics

### Creating an intent parameter

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:)-90j68)

Creates an app intent parameter.

[`convenience init<Query>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, query: Query)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:query:)-4yyz3)

Creates an app intent parameter with an entity search query.

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:resolvers:)-9fsdb)

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

### Deprecated intiializers

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: [IntentWidgetFamily : IntentCollectionSize], inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:)-7cox5)

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

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: IntentCollectionSize, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:resolvers:)-1f92a)

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

[`convenience init<Query>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: [IntentWidgetFamily : IntentCollectionSize], inputConnectionBehavior: InputConnectionBehavior, query: Query)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:query:)-1rwev)

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

[`convenience init<Query>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: IntentCollectionSize, inputConnectionBehavior: InputConnectionBehavior, query: Query)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:query:)-7yfm3)

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

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: IntentCollectionSize, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:resolvers:)-1f92a)

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

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: [IntentWidgetFamily : IntentCollectionSize], inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:resolvers:)-8o0lz)

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

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, size: IntentCollectionSize, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:default:size:inputConnectionBehavior:)-8bfkz)

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

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

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

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

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

[`convenience init(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:)-tfj8)

Creates an app intent parameter.

[`convenience init<Query>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, query: Query)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:query:)-49n42)

Creates an app intent parameter with an entity search query.

[`convenience init<Spec>(title: LocalizedStringResource, description: LocalizedStringResource?, default: Value.UnwrappedType?, requestValueDialog: IntentDialog?, requestDisambiguationDialog: IntentDialog?, inputConnectionBehavior: InputConnectionBehavior, resolvers: () -> Spec)`](/documentation/AppIntents/IntentParameter/init(title:description:default:requestValueDialog:requestDisambiguationDialog:inputConnectionBehavior:resolvers:)-1csrx)

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


---

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)