Wishlist CSV Format
This document describes the CSV file format produced by Export Wishlist CSV and accepted by Import Wishlist CSV (macOS).
File Overview
A Wishlist CSV export is a plain UTF-8 text file containing one wishlist item per row. It can be opened in any spreadsheet application (Numbers, Excel, Google Sheets) and re-imported into Discography.
Filename
Export files are named using a compact ISO timestamp:
Wishlist-<yyyyMMdd-HHmmss>.csv
Example: Wishlist-20261012-143022.csv
Save Location
The destination folder is chosen by the user in the Export window. The folder picker defaults to:
~/Documents/Discography/
Any folder on the local file system can be selected. The chosen folder is created automatically if it does not already exist.
File Requirements
| Property | Requirement |
|---|---|
| Encoding | UTF-8 |
| Line endings | \n (LF) on export; \n, \r\n, or \r all accepted on import |
| Delimiter | Comma (,) |
| Quoting | All fields are wrapped in double quotes on export; internal double quotes are escaped as "" (RFC 4180) |
| Header row | Required — first row must contain column names |
Columns
Column order does not matter — the importer maps columns by name, not by position.
Required columns (import)
These columns must be present or the import will fail with an error.
| Column | Type | Notes |
|---|---|---|
title |
string | Wishlist item title |
artist |
string | Artist or band name |
All columns
| Column | Type | Nullable | Notes |
|---|---|---|---|
title |
string | No | Item title |
artist |
string | No | Artist or band name |
year |
integer | No | Release year. 0 = unknown |
country |
string | Yes | Two-letter ISO 3166-1 alpha-2 country code (e.g. US, GB), XW (worldwide), or XE (Europe). Blank = unknown |
musicBrainzID |
string (UUID) | Yes | MusicBrainz Release ID |
format |
string | Yes | Physical media format. See Format values. Blank or unrecognised values default to CD |
releaseType |
string | Yes | Release category. See Release type values. Blank = none set |
upc |
string | Yes | Universal Product Code (barcode) |
catalogNumber |
string | Yes | Label catalog number |
label |
string | Yes | Record label name |
notes |
string | Yes | Free-text personal notes (may contain newlines) |
dateAdded |
string (ISO 8601 UTC) | Yes | Timestamp when the item was added to the Wishlist. Blank values default to the current time on import |
Note: Cover art is not included in the CSV export. Artwork must be re-added manually or via MusicBrainz lookup after importing.
Import Modes
The import panel offers two modes:
| Mode | Behaviour |
|---|---|
| Replace Wishlist | All existing wishlist items are deleted before the new items are inserted |
| Append to Wishlist | New items are added alongside existing items. No duplicate detection is performed |
Enumeration Values
Format values
Stored in the format column. Values are case-sensitive on export; recognised case-insensitively on import.
| Value | Description |
|---|---|
Vinyl |
Vinyl record (LP, 7", 10", 12") |
CD |
Compact disc |
Cassette |
Cassette tape |
DVD |
DVD video or audio |
Blu-Ray |
Blu-ray disc |
8-Track |
8-track cartridge |
Other |
Any other physical format |
Release type values
Stored in the releaseType column.
| Value | Description |
|---|---|
Album |
Full-length album or LP |
EP |
Extended play |
Single |
Single |
Comp |
Compilation |
What Is Not Included
The following data is not exported to CSV:
- Cover art (embedded image data)
- Tracklist
- Credits
- Tags
These fields become available after moving a wishlist item into your collection.
Example
"title","artist","year","country","musicBrainzID","format","releaseType","upc","catalogNumber","label","notes","dateAdded"
"Abbey Road","The Beatles","1969","GB","b84ee12a-09ef-421b-82de-0441a926375b","Vinyl","Album","094638246824","PCS 7088","Apple Records","Original UK pressing.","2026-10-05T10:30:00Z"
"Kind of Blue","Miles Davis","1959","US","","CD","Album","","CK 40579","Columbia","","2026-10-06T14:22:10Z"
"Never Mind the Bollocks","Sex Pistols","1977","GB","","Vinyl","Album","","V2086","Virgin Records","","2026-10-08T09:15:33Z"
Tip: Column order does not matter — the importer maps columns by name. A CSV edited in a spreadsheet application and re-saved in a different column order will still import correctly.