<!--
{
  "documentType" : "article",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/user-defined-property-keys",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "User-defined property keys"
}
-->

# User-defined property keys

Properties for obtaining user-defined metadata for a media item.

## Discussion

Obtain user-defined metadata for a media item by calling the [`value(forProperty:)`](/documentation/MediaPlayer/MPMediaEntity/value(forProperty:)) method with these property keys. Don’t use user-defined properties to build media property predicates.

## Topics

### User-defined property keys

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

The number of times the user has skipped playing the item.

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

The user-specified rating of the object in the range `[0...5]`, where a value of 5 indicates the most favorable rating.

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

The most recent calendar date on which the user played the media item.

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

Corresponds to the “Grouping” field in the Info tab in the Get Info dialog in iTunes.

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

The user’s place in the media item the most recent time it was played.

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

The date the media item was added to the user’s Media library.


---

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)