<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/app-schema-domain-video",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Video"
}
-->

# Video

Make your video app’s actions available to Apple Intelligence and Siri by adopting schemas for common video playback and watchlist actions.

## Discussion

The `.video` domain defines app schemas that provide a
structured representation for common video playback actions and content.
Apply schemas in the `.video` domain to make your app’s video functionality available to Apple Intelligence and Siri.
Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across video apps.
For example, a person can play a show with the same phrases on different apps that support the
[`playContent`](/documentation/AppIntents/AppSchema/VideoIntent/playContent) schema.

This table maps example phrases that apply to each schema:

|Video intent schemas                                                                             |Example phrases                                                                    |
|-------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/VideoIntent/playContent``        |“Play Severance.” or “Watch the Inter Miami match.”                                |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/VideoIntent/playTrailer``        |“Play the trailer for Silo.” or “Watch the Pluribus trailer.”                      |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/VideoIntent/addToWatchList``     |“Add The Morning Show to my watchlist.” or “Put Shrinking in my up next queue.”    |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/VideoIntent/removeFromWatchList``|“Remove Ted Lasso from my watchlist.” or “Delete Foundation from my up next queue.”|

> Tip: Xcode generates a template implementation when you type `video_` and select a schema from the suggestions list.

For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai).

## Support video playback use-case groups

A *use-case group* is a set of related schemas that share a single purpose.
The use-case group for video playback comprises the [`playContent`](/documentation/AppIntents/AppSchema/VideoIntent/playContent) schema and an [`IntentValueQuery`](/documentation/AppIntents/IntentValueQuery).
Your app’s implementation of the query finds video content for playback.
Xcode reports a build warning if your app supports one without the other.

> Important: To integrate your app with Apple Intelligence and bring it to Siri AI, adopt both parts of the playback use-case group.

## Topics

### Actions

[`var addToWatchList: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/VideoIntent/addToWatchList)

An intent schema that adds a piece of video content to a person’s watchlist in the TV app.

[`var playContent: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/VideoIntent/playContent)

An intent schema that plays a piece of video content.

[`var playTrailer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/VideoIntent/playTrailer)

An intent schema that plays a trailer for a piece of supported video content.

[`var removeFromWatchList: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/VideoIntent/removeFromWatchList)

An intent schema that removes a piece of video content from a person’s watchlist in the TV app.

[`protocol VideoIntent`](/documentation/AppIntents/AppSchema/VideoIntent)

Identifies intent schemas in the video domain.

### Content and parameter types

[`var contentCreator: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/contentCreator)

An entity schema for a content creator.

[`var freeformVideo: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/freeformVideo)

An entity schema for a freeform video.

[`var image: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/image)

An entity schema for an image.

[`var movie: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/movie)

An entity schema for a movie.

[`var person: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/person)

An entity schema for a person.

[`var tvEpisode: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/tvEpisode)

An entity schema for a tv episode.

[`var tvSeason: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/tvSeason)

An entity schema for a tv season.

[`var tvShow: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/VideoEntity/tvShow)

An entity schema for a tv show.

[`protocol VideoEntity`](/documentation/AppIntents/AppSchema/VideoEntity)

Identifies entity schemas in the video domain.

### Types for static parameters

[`var imageType: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/VideoEnum/imageType)

An enum schema for an image type parameter.

[`var personRole: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/VideoEnum/personRole)

An enum schema for a person role parameter.

[`var videoContentType: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/VideoEnum/videoContentType)

An enum schema for a video content type parameter.

[`protocol VideoEnum`](/documentation/AppIntents/AppSchema/VideoEnum)

Identifies enum schemas in the video domain.



---

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)