Share via

list.csv

  • Article

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

This file contains an entry for each of the lists the catalog contains. Lists can be lists of tracks, albums, artists, genres, subgenres, or radio feeds; or they can be lists of other lists. Each list entry is a row composed of the tab-delimited fields described in the table below. Fields must appear in the order listed.

The Format column in the table below describes the way each Unicode text field is formatted. It does not refer to the data type of the contents. For example, if Integer is indicated in the Format column, it means that the field contains a Unicode string representing an integral value, rather than an actual integer.

Field Required Format Description
ListID Yes Non-negative integer. List identifier, unique within list.csv. Must be non-negative and less than 2^32.Displaying a list node in tree view control: If the ListID is 0, 1, 2, 3, 4, 5, 6, or 7, the list will appear as a custom node under your online store's top-level node in the Player's tree view control. Custom nodes appear before the standard nodes under the online store's top-level node, and they are positioned in ascending order by ListID. For example, if there are three custom nodes, with ListIDs of 1, 3, and 5, they will be displayed first, second, and third under the online store's top level node.
ListTitle No Unicode string.Example: Top Ten Hits
 List title.
ListSubtitle No Unicode string List alternate title, displayed in the second line of the Tile view.
ListDescription Yes Unicode string List friendly display text (displayed in property pages).
Linked_ItemType Yes Unicode string.Format: [T|P|A|L|G|S|R]
Example: T
 Indicates the type of the linked items.
  • T= Track
  • P = Performer
  • A = Album
  • L = List
  • G = Genre
  • S = Subgenre
  • R = Radio
ListPrice Yes Unicode string.Example: $9.99
 Price of the list. The currency symbol should be included.A zero means the list is free. No value means the price is unknown. A hyphen means the list cannot be purchased.
Popularity Yes Integer or decimal value.Example: 1259.3
 Indicates the popularity ranking when this list appears in other lists. Can be zero if not applicable..
IsRecentlyAdded Yes Boolean.Format: [0|1]
Example: 0
 Indicates whether the list was recently added.
IsFeatured Yes Boolean.Format: [0|1]
Example: 0
 Indicates whether the list is featured. Can be used in determining sort order.
EditorialGlyph Yes Non-negative integer. Should be 0. Not used in this release. Should be 0.
ViewType Yes Unicode string. Format: [I|T|R|L|O]Example: T
 Indicates the view type to use for the list.
  • I = Icon
  • T = Tile
  • R = Report
  • L = List
  • O = Ordered List
ViewImageSize Yes Non-negative integer.Example: 180
 The size at which the list image is displayed. If 0, size is determined automatically.
GroupBy Yes Unicode string.Format: [-|P|A|C|R|D]
Example: P
 Indicates what field is used to group the items in the list.
  • - = Automatic
  • P = Performer
  • A = Album
  • C = Composer
  • R = Rating
  • D = Date
ListItemsAreDynamic Yes Boolean. Can be 0 or 1. Indicates whether the list is generated dynamically. Dynamic lists do not have items in listitem.csv. If a list is marked as dynamic, its items are provided by IWMPContentPartner::GetListContents