---
title: timedMetadata
framework: avfoundation
role: symbol
role_heading: Instance Property
path: avfoundation/avplayeritem/timedmetadata
---

# timedMetadata

An array of the most recently encountered timed metadata.

## Declaration

```swift
@MainActor var timedMetadata: [AVMetadataItem]? { get }
```

## Return Value

Return Value An array of AVMetadataItem or nil if no metadata was found.

## Discussion

Discussion Prior to the player item loading its media, this property value is nil. You can key-value observe this property to monitor when metadata becomes available.