<!--
{
  "availability" : [
    "macCatalyst: 14.0.0 -",
    "macOS: 10.13.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "iTunesLibrary",
  "identifier" : "/documentation/iTunesLibrary/ITLibPlaylist",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "iTunes Library"
    ],
    "preciseIdentifier" : "c:objc(cs)ITLibPlaylist"
  },
  "title" : "ITLibPlaylist"
}
-->

# ITLibPlaylist

This class describes a playlist in the iTunes library.

```
class ITLibPlaylist
```

## Overview

A *playlist* is a collection of media items (tracks). The user creates and organizes playlists manually, or iTunes automatically generates them. Playlists are media entities. Each contains a unique identifier and a set of properties. Playlists can form a hierarchical structure. In those cases, the [`parentID`](/documentation/iTunesLibrary/ITLibPlaylist/parentID) property of [`ITLibPlaylist`](/documentation/iTunesLibrary/ITLibPlaylist) returns the persistent ID of the parent playlist.

## Topics

### Getting Playlist Info

[`name`](/documentation/iTunesLibrary/ITLibPlaylist/name)

The name or title of the playlist.

[`items`](/documentation/iTunesLibrary/ITLibPlaylist/items)

The media items (tracks) in the playlist.

[`parentID`](/documentation/iTunesLibrary/ITLibPlaylist/parentID)

The unique persistent identifier of the playlist’s parent playlist.

[`primary`](/documentation/iTunesLibrary/ITLibPlaylist/isPrimary)

A Boolean value that indicates whether the playlist is the primary playlist.

[`visible`](/documentation/iTunesLibrary/ITLibPlaylist/isVisible)

A Boolean value that indicates whether the playlist is visible to the user in iTunes.

[`distinguishedKind`](/documentation/iTunesLibrary/ITLibPlaylist/distinguishedKind)

An indication of whether the playlist has a special distinction.

[`kind`](/documentation/iTunesLibrary/ITLibPlaylist/kind)

An indication of the type of playlist.

[`ITLibPlaylistKind`](/documentation/iTunesLibrary/ITLibPlaylistKind)

These constants specify the possible kinds of playlists.

[`ITLibDistinguishedPlaylistKind`](/documentation/iTunesLibrary/ITLibDistinguishedPlaylistKind)

These constants specify the possible kinds of distinguished playlists.

### Playlist Properties

[`ITLibPlaylistPropertyAllItemsPlaylist`](/documentation/iTunesLibrary/ITLibPlaylistPropertyAllItemsPlaylist)

A Boolean value that indicates whether the API exposes every item in the playlist.

[`ITLibPlaylistPropertyDistinguisedKind`](/documentation/iTunesLibrary/ITLibPlaylistPropertyDistinguisedKind)

An indication of whether the playlist has a special distinction.

[`ITLibPlaylistPropertyItems`](/documentation/iTunesLibrary/ITLibPlaylistPropertyItems)

The media items (tracks) in the playlist.

[`ITLibPlaylistPropertyKind`](/documentation/iTunesLibrary/ITLibPlaylistPropertyKind)

An indication of the type of playlist.

[`ITLibPlaylistPropertyPrimary`](/documentation/iTunesLibrary/ITLibPlaylistPropertyPrimary)

A Boolean value that indicates whether the playlist is the primary playlist.

[`ITLibPlaylistPropertyName`](/documentation/iTunesLibrary/ITLibPlaylistPropertyName)

The name or title of the playlist.

[`ITLibPlaylistPropertyParentPersistentID`](/documentation/iTunesLibrary/ITLibPlaylistPropertyParentPersistentID)

The unique persistent identifier of the playlist’s parent playlist.

[`ITLibPlaylistPropertyVisible`](/documentation/iTunesLibrary/ITLibPlaylistPropertyVisible)

A Boolean value that indicates whether the playlist is visible to the user in iTunes.

### Deprecated

[`allItemsPlaylist`](/documentation/iTunesLibrary/ITLibPlaylist/isAllItemsPlaylist)

Indicates whether the API exposes every item in the playlist.

[`master`](/documentation/iTunesLibrary/ITLibPlaylist/isMaster)

A Boolean value that indicates whether the playlist represents the entire iTunes library.

[`ITLibPlaylistPropertyMaster`](/documentation/iTunesLibrary/ITLibPlaylistPropertyMaster)

A Boolean value that indicates whether the playlist represents the entire iTunes library.

## Relationships

### Conforms To

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

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

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

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

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

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

### Inherits From

[`ITLibMediaEntity`](/documentation/iTunesLibrary/ITLibMediaEntity)

---

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)