<!--
{
  "availability" : [
    "iOS: 3.0.0 -",
    "iPadOS: 3.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/MPMediaPlaylist",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Media Player"
    ],
    "preciseIdentifier" : "c:objc(cs)MPMediaPlaylist"
  },
  "title" : "MPMediaPlaylist"
}
-->

# MPMediaPlaylist

A playable collection of related media items.

```
class MPMediaPlaylist
```

## Overview

Each playlist has a name, a set of attributes, and a unique identifier that persists across application launches.

Users configure playlists using iTunes or by creating a playlist on the device. Playlists are read-only to your iOS app. To obtain playlists, configure a media query that’s grouped by playlist. Each returned media item collection is a media playlist. The following code snippet illustrates this by logging playlist and song names to the Xcode debugger console:

```swift
let myPlaylistQuery = MPMediaQuery.playlists()
let playlists = myPlaylistQuery.collections
for playlist in playlists! {
    print(playlist.value(forProperty: MPMediaPlaylistPropertyName)!)
            
    let songs = playlist.items
    for song in songs {
        let songTitle = song.value(forProperty: MPMediaItemPropertyTitle)
        print("\t\t", songTitle!)
    }
}
```

[`MPMediaPropertyPredicate`](/documentation/MediaPlayer/MPMediaPropertyPredicate) and [`MPMediaQuery`](/documentation/MediaPlayer/MPMediaQuery) describe the API for building a media query. [`MPMediaEntity`](/documentation/MediaPlayer/MPMediaEntity) describes the methods for querying media playlist property values.

## Topics

### Adding media items to a playlist

[`-  addItemWithProductID:completionHandler:`](/documentation/MediaPlayer/MPMediaPlaylist/addItem(withProductID:completionHandler:))

Adds the item associated with the product identifier to the end of the playlist.

[`-  addMediaItems:completionHandler:`](/documentation/MediaPlayer/MPMediaPlaylist/add(_:completionHandler:))

Adds an array of media items to the end of the playlist.

### Retrieving information about a playlist

[`authorDisplayName`](/documentation/MediaPlayer/MPMediaPlaylist/authorDisplayName)

The display name for the playlist defined in the app.

[`descriptionText`](/documentation/MediaPlayer/MPMediaPlaylist/descriptionText)

User supplied text that describes the playlist.

[`name`](/documentation/MediaPlayer/MPMediaPlaylist/name)

The name of the playlist.

[`persistentID`](/documentation/MediaPlayer/MPMediaPlaylist/persistentID)

The persistent identifier for the playlist.

[`cloudGlobalID`](/documentation/MediaPlayer/MPMediaPlaylist/cloudGlobalID)

The cloud identifier for the playlist.

[`playlistAttributes`](/documentation/MediaPlayer/MPMediaPlaylist/playlistAttributes)

The attributes associated with the playlist.

[`MPMediaPlaylistAttribute`](/documentation/MediaPlayer/MPMediaPlaylistAttribute)

Attributes define the type of playlist.

[`seedItems`](/documentation/MediaPlayer/MPMediaPlaylist/seedItems)

The items seeded to generate the playlist; applies only to Genius playlists.

### Property keys

[Playlist property keys](/documentation/MediaPlayer/playlist-property-keys)

Keys that contain information about a playlist.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

### Inherits From

[`MPMediaItemCollection`](/documentation/MediaPlayer/MPMediaItemCollection)

---

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)