How to Manage Recording Versions - Docs

A recording version is one specific performance, arrangement, mix, or master of a song. Use versions to keep files, artists, credits, master owners, recording details, and project associations separate when the audio represents a different version of the composition.

Quick answer

Open a song and use the song actions menu to create, edit, or delete a recording version. Use the version selector beside the song title to switch versions when a song has more than one.

When to Create a New Version

Create a new recording version when the change affects the identity of the recording, not just a file revision. If you are only replacing a mix file or adding another file for the same performance, keep it under the same version.

Situation	Use
Demo, acoustic take, remix, or live recording	New recording version
Radio edit or alternate master with separate metadata	New recording version
Mix v2, revised WAV, MP3 reference, stems	Same recording version, new or updated file
Same audio, but a different project association	Edit the recording version

Create a Recording Version

To create a new recording version:

Open the song and click the song actions menu in the header.
Select New Version.
Enter a version title such as Acoustic Version, Radio Edit, Live Recording, or Remix.
Add optional notes.
Choose whether this should be the primary version.
Optionally associate the version with a project.
Click Create Version.

If a song does not already have a primary version, the new version is saved as primary. If you mark a new version as primary, Songkeeper clears the primary flag from the other versions for that song.

Edit a Recording Version

To modify a recording version:

Select the version from the version selector, if the song has multiple versions.
Open the song actions menu and choose Edit Version.
Update the title, notes, primary-version setting, or project association.
Click Update Version.

Primary version

The primary version is the default recording version Songkeeper selects for the song. Use it for the current main version of the recording, then switch it when another version becomes the main one.

Delete a Recording Version

To remove a recording version:

Select the version you want to delete.
Open the song actions menu and select Delete Version.
Review the delete-impact dialog and confirm deletion.

Deletion is destructive

Deleting a recording version can permanently delete its audio files and asset files. When related release tracks, recording claims, tracking-sheet entries, handoffs, or share links exist, Songkeeper shows those impacts before you confirm.

If you delete the primary version and another version exists, Songkeeper promotes another version to primary. If no versions remain, the song has no selected recording version until you create one.

Recording Version Fields

Field	Purpose
Title	Names the version in the version selector and recording metadata.
Notes	Stores context about what makes this version different.
Primary version	Controls the default recording version Songkeeper selects for the song.
Associated project	Connects this version to a project for organization and project workflows.

The version modal only manages the version identity fields. Use the Recording Info tab for detailed recording metadata.

Recording metadata - artists, performers, credits, master ownership, technical details, label, studio, and dates.
Song vs recording versions - how songs, recording versions, and files relate to each other.
Files and audio - demos, mixes, masters, stems, and assets attached to versions.