Skip to main content
Version: v2.10.0

Interface: Track

Represents a playable audio track used internally by the player. Includes metadata, playback options, and plugin data.

Property Type Description Optional
artworkUrlstring | nullURL to the track's artwork image, or null if unavailable.
authorstringTrack author or channel name.
customDataRecord<string, unknown>Developer-defined metadata attached to the track.
displayThumbnail(size?)(Sizes) => string | nullReturns a YouTube thumbnail URL at the given resolution, or null for unsupported sources.
durationnumberDuration of the track in milliseconds.
identifierstringUnique platform identifier (e.g. YouTube video ID).
isAutoplaybooleanWhether this track was added by the autoplay system.
isrcstringISRC (International Standard Recording Code) for the track.
isSeekablebooleanWhether the track supports seeking.
isStreambooleanWhether the track is a live stream.
pluginInfoTrackPluginInfoAdditional plugin-specific metadata for the track.
requesterAnyUserThe user who requested the track.
sourceNameTrackSourceNameThe source platform of the track (e.g. "YouTube", "Spotify").
thumbnailstring | nullYouTube thumbnail URL, or null for unsupported sources.
titlestringTitle of the track.
trackstringBase64-encoded Lavalink track string.
uristringOriginal source URL of the track.