<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/donations-and-discovery",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Donations and discovery"
}
-->

# Donations and discovery

Donate your app’s intents and entities to the system to help it identify trends and predict
future behaviors.

## Overview

When someone performs an action in your app’s interface, create a matching app intent and donate
it to the system. Donations help the system analyze a person’s current actions and predict their future
actions. For example, if someone asks your app for the weather each morning, the system might
proactively suggest the same action each morning. Restrict your donations to direct interactions
with your app’s interface, and not to interactions started by Siri or the Shortcuts app.

You can also improve the quality of your app’s searchable content by donating app entities to
the system. Donate entities to Spotlight with the rest of your app’s content so the system can
use them to display content directly in your app. In your app’s interface, associate entities with
views to communicate the data your app currently shows. Apple Intelligence and Siri use your
donations to improve conversational results.

## Topics

### Essentials

[Donating your app’s data and actions to the system](/documentation/AppIntents/donating-your-apps-data-and-actions-to-the-system)

Improve how people interact with your app through Apple Intelligence and Siri
by teaching the system about your app’s data and actions.

### Donation management

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

A type you use to teach the system about the actions people take using your app.

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

An opaque type that identifies a specific donation to the system.

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

A type you use to specify previously donated app intents.

### Spotlight donations

[Making app entities available in Spotlight](/documentation/AppIntents/making-app-entities-available-in-spotlight)

Update your app entity types to support Spotlight indexing, and donate entities to
make them findable in searches.

### Onscreen context

[Providing contextual cues to Apple Intelligence and Siri](/documentation/AppIntents/providing-contextual-cues-to-apple-intelligence-and-siri)

Annotate your interface with app entities to offer contextual information about your app’s
onscreen content.

### Intent relevance

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

A type that stores an app intent and indicates its relevance to someone.

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

A type you use to suggest app intents and their current relevance to a person.

  <doc://com.apple.documentation/documentation/RelevanceKit/RelevantContext>

### Entity relevance

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

A type you use to donate your app’s songs, albums, artists, and other media
items to play during workouts.

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

The context used to scope suggested entity donations to a specific domain.

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

Specifies the type of audio activity to associate with a suggested entity,
allowing the system to surface relevant suggestions at the right moment.


---

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)