Import / Export, open from Settings → Data
How to get here
Open Settings and tap Import / Export under the Data section. The screen has an Export card at the top and an Import card below it.
Exporting
Five sections are listed with check marks — tick any combination:
- Songs and contentEvery song with its chords, lyrics, and notes.
- Familiarity ratingsPer-song Lyrics and Music star ratings.
- TagsTags and the songs they're attached to.
- Set listsEvery set list, song order, and per-song field selections.
- Practice settings and historySession size, scheduled intervals, and the full practice log.
Tap Export and Song Hive builds a .songhive file containing only the ticked sections and hands it to iOS's share sheet.
Importing
Tap Pick file and choose a .songhive file from anywhere iOS's file picker can reach (Files, iCloud Drive, Dropbox, Google Drive, a share-sheet handoff). Song Hive inspects the file, shows you which sections it contains, and asks how to bring them in:
- MergeUpsert songs, union tags, skip duplicate practice log entries. Nothing is deleted.
- OverwriteDelete songs and set lists not present in the file; wipe the practice log and re-seed from the file.
Songs in the file match against your library by id first, then by name + artist, so a cross-device import lines up with the same songs you already have.
Free-plan awareness
If you're on the free plan and the projected library size after import would exceed the 15-song limit, Song Hive shows an upgrade prompt (or an "import the first 15" option) before touching your library.
Legacy files
Older exports from before the section picker existed are still accepted. Song Hive detects the legacy format automatically and pre-checks the songs, familiarity, and tags sections on the way in.
Alongside iCloud
Import / Export is deliberate and file-based; iCloud sync is automatic and continuous. Use iCloud for day-to-day device-to-device; use Export for manual backups or selective transfers.
