Import songs from CSV

Updated 2 min read

Applies toBandArtist profileRequiresContributor or higher

Import songs from CSV adds songs from a CSV file to the current repertoire. Choose a file, map its columns to song fields and review the preview before importing.

Open the import

  1. Open Songs under Repertoire in the side menu.
  2. Select Import, then From CSV….

Available in a band and an artist profile, on every subscription level. Contributor or higher.

The title is Import songs from CSV. The import stays in this dialog through file selection, column mapping, preview and the result.

Choose a file

Select Choose CSV file and choose a UTF-8 CSV file with column headers. Use up to 1,000 data rows per import. Split larger lists into separate files.

Map columns

The app matches familiar column headers automatically, including Title, Song, Artist, Band, Album, Key, BPM and Genre. Check each mapping and select the column containing that field. Choose (not mapped) for optional fields you do not want to import. Title must be mapped.

FieldWhat to import
TitleThe song title.
ArtistThe performing artist. The title and artist together identify duplicates.
AlbumThe album title. The import finds or creates the album and attaches the song to it.
Release dateThe album's release date, for example 2024-05-17. A year such as 2024 becomes 1 January of that year; a year and month such as 2024-05 becomes the first day of that month.
KeyThe song's key, as text.
TempoA numeric tempo.
DurationMinutes and seconds, hours, minutes and seconds, or a number of seconds: 3:45, 1:02:03 or 225.
TagsTags separated by commas or semicolons. In a comma-separated CSV, quote a cell containing commas.

Preview and import

  1. Select Preview. The table shows the first five rows with their mapped title, artist, album, release date, key, tempo and tags.
  2. Review the mapped values. The count above the preview covers the whole file.
  3. Select Import n rows, where n is the number of data rows.
  4. Select Close after importing to return to the refreshed repertoire.

The import adds songs; it does not update existing songs. Songs with the same title and artist are skipped, ignoring letter case, both against the repertoire and within the file.

Actions

ActionWhereWhat it does
Choose CSV fileFile selectionReads the file and opens column mapping.
PreviewColumn mappingShows a sample before importing.
Import n rowsPreviewImports the mapped data from the whole file.
CancelBefore importCloses without importing.
CloseAfter importReturns to Songs.

Next steps