<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INAddMediaIntent",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INAddMediaIntent"
  },
  "title" : "INAddMediaIntent"
}
-->

# INAddMediaIntent

A request to add a media item.

```
class INAddMediaIntent
```

## Overview

Siri creates an [`INAddMediaIntent`](/documentation/Intents/INAddMediaIntent) object when the user asks to add a media item. The intents object contains the media to add.

To handle this intent, the handler object in your Intents extension must adopt the [`INAddMediaIntentHandling`](/documentation/Intents/INAddMediaIntentHandling) protocol. Your handler should confirm the request and create an [`INAddMediaIntentResponse`](/documentation/Intents/INAddMediaIntentResponse) object that contains the media to add.

### Additional Intent Attributes

The following table lists additional attributes of this intent object:

|Attribute                      |Description              |
|-------------------------------|-------------------------|
|Supported by                   |Siri Intents (audio only)|
|Always requires unlocked device|No                       |

## Topics

### Creating an Add Media Intent

[`-  initWithMediaItems:mediaSearch:mediaDestination:`](/documentation/Intents/INAddMediaIntent/init(mediaItems:mediaSearch:mediaDestination:))

Creates an intent that describes the media items to add and where to add them.

### Accessing the Media

[`mediaItems`](/documentation/Intents/INAddMediaIntent/mediaItems)

The media content to add.

[`mediaSearch`](/documentation/Intents/INAddMediaIntent/mediaSearch)

The location to search for the media item to add.

[`mediaDestination`](/documentation/Intents/INAddMediaIntent/mediaDestination)

The location for the media to add.

[`INMediaDestination`](/documentation/Intents/INMediaDestination-swift.enum)

An object that describes the destination for a media item.

[`INMediaDestinationReference`](/documentation/Intents/INMediaDestinationReference)

An object that describes the destination for a media item.

## Relationships

### Conforms To

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`INIntentSetImageKeyPath`](/documentation/Intents/INIntentSetImageKeyPath)

[`Equatable`](/documentation/Swift/Equatable)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

### Inherits From

[`INIntent`](/documentation/Intents/INIntent)

---

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)