---
title: MPMediaPlaylist
framework: mediaplayer
role: symbol
role_heading: Class
path: mediaplayer/mpmediaplaylist
---

# MPMediaPlaylist

A playable collection of related media items.

## Declaration

```swift
class MPMediaPlaylist
```

## Overview

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: MPMediaPropertyPredicate and MPMediaQuery describe the API for building a media query. MPMediaEntity describes the methods for querying media playlist property values.

## Topics

### Adding media items to a playlist

- [addItem(withProductID:completionHandler:)](mediaplayer/mpmediaplaylist/additem(withproductid:completionhandler:).md)
- [add(_:completionHandler:)](mediaplayer/mpmediaplaylist/add(_:completionhandler:).md)

### Retrieving information about a playlist

- [authorDisplayName](mediaplayer/mpmediaplaylist/authordisplayname.md)
- [descriptionText](mediaplayer/mpmediaplaylist/descriptiontext.md)
- [name](mediaplayer/mpmediaplaylist/name.md)
- [persistentID](mediaplayer/mpmediaplaylist/persistentid.md)
- [cloudGlobalID](mediaplayer/mpmediaplaylist/cloudglobalid.md)
- [playlistAttributes](mediaplayer/mpmediaplaylist/playlistattributes.md)
- [MPMediaPlaylistAttribute](mediaplayer/mpmediaplaylistattribute.md)
- [seedItems](mediaplayer/mpmediaplaylist/seeditems.md)

### Property keys

- [Playlist property keys](mediaplayer/playlist-property-keys.md)

## Relationships

### Inherits From

- [MPMediaItemCollection](mediaplayer/mpmediaitemcollection.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)
- [NSSecureCoding](foundation/nssecurecoding.md)

## See Also

### Media items and playlists

- [Providing animated artwork for media items](mediaplayer/providing-animated-artwork-for-media-items.md)
- [MPMediaItem](mediaplayer/mpmediaitem.md)
- [MPMediaItemArtwork](mediaplayer/mpmediaitemartwork.md)
- [MPMediaItemAnimatedArtwork](mediaplayer/mpmediaitemanimatedartwork.md)
- [MPMediaItemCollection](mediaplayer/mpmediaitemcollection.md)
- [MPMediaPlaylistCreationMetadata](mediaplayer/mpmediaplaylistcreationmetadata.md)
- [MPMediaEntity](mediaplayer/mpmediaentity.md)