# App Intents updates Learn about important changes in App Intents. ## Overview Browse notable changes in . ## June 2026 ### Apple Intelligence - Integrate your app with Apple intelligence by conforming your app intents, app entities, and app enums to an app schema in one of the . - Indicate that your app entities have identifiers that remain stable across devices by adopting , so people can continue a task on another device. - Prompt for confirmation before destructive or sensitive actions on shared or publicly accessible entities by adopting and returning an value. - Enable Apple Intelligence to suggest media-related entities like songs or albums during workouts and similar contexts with . - Bridge your app entities to system intent value types by using in your entity’s `transferRepresentation` property. ### App intents - Let people perform App Shortcuts, custom shortcuts, system actions, or open another app from interactive widgets with . - Extend an app intent’s background runtime by adopting and calling with a value, reporting progress as the task runs. - Handle cancellation cleanup gracefully by adopting . Inspect to distinguish a deliberate cancellation from a timeout. - Reverse the effect of an app intent’s action by adopting . - Specify whether your app intent runs in the foreground, the background, or both by setting the `supportedModes` property to an value, then consult inside `perform()` to adapt your code at runtime. - Tell the system which target may perform your app intent or entity query — the main app, the App Intents extension, or a widget extension — by setting the `allowedExecutionTargets` property to an option set. ### App entities - Refer to a large set of entities efficiently using , which stores only entity identifiers and resolves the full instances on demand. Use the type for an app intent parameter to avoid resolving every identifier during parameter resolution. - Define union-type Shortcuts parameters with rich picker UI and custom metadata by adopting on the type the `@UnionValue` macro generates, along with the cases enum. - Have the system retrieve indexed entities by identifier from the Spotlight index by adopting . ### Errors - Provide a localized description for failures by initializing an with `init(description:)`, or wrap an existing error that conforms to . ## June 2025 - Create app intents that conform to to display an interactive snippet. - Make app entities available in Spotlight that conform to and use the `@ComputedProperty(indexingKey:)` or `@Property(indexingKey:)` Swift macros for attributes you want to add to the Spotlight index. - Integrate your app with visual intelligence by providing app entities to the system using an . - Create an that conforms to the protocol and associate the app entity with a using the activity’s property to make onscreen content available to Siri without adopting an assistant schema. ## November 2024 ### Siri and Apple Intelligence - Make onscreen content available to Siri and Apple Intelligence by describing it as an and adopting an assistant schema. Additionally, adopt the protocol, and associate the app entity with a using the activity’s property. ## June 2024 ### System integration - Integrate your app with Siri and Apple Intelligence using . - Use and to allow users to put controls on the Lock Screen or in Control Center. - Create a locked camera capture extension for your app and implement a to allow people to capture photos and videos from controls or the Action button. - Create app intents that capture audio by implementing . - Allow people to find app entities in Spotlight by adopting the protocol. ### Content sharing - Make it possible to share and transfer data you describe as by conforming to . - Receive content other apps make available with app intents by using for your app intent parameters. - Describe the file that stores your app intent data using . ### General - Provide additional information about errors with , , and . - Pass a condition to to only require user confirmation if a person’s context meets the provided condition. - Use , , and to represent your app intents, app entities, and app enums as universal links that you use to provide deep links to your app’s content. - Define a set of types for an intent parameter using the macro to create flexible app intents because a parameter can be of one of several pre-defined union types. - Create entities that have just one singular instance with and the corresponding . For example, to provide an app intent for app settings that appear in your app or in System Settings, create a singleton entity that encapsulates all settings as properties. Use it in the app intent that offers actions to change your app’s settings. --- Copyright © 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)