Upload a finished audio file directly into your Patchline catalog. Patchline stores it securely, extracts ID3 metadata, queues sonic analysis, and makes it searchable. Best for unreleased work or when you want your master to live in Patchline alongside the catalog metadata. Per-tier upload limits: Free 3 lifetime · Starter 25 · Pro 200 · Scale 1,000 · Enterprise unlimited.Documentation Index
Fetch the complete documentation index at: https://docs.patchline.ai/llms.txt
Use this file to discover all available pages before exploring further.
When to upload vs import
| Upload (this page) | Import | |
|---|---|---|
| Use when | Track is unreleased or you want the master in Patchline | Track is already released on a streaming platform |
| Audio file in Patchline | Yes (secure, versioned storage) | No |
| Sonic analysis runs | Yes, on your master | Yes, via the streaming source |
| Storage cost | Counts against your storage limit | None |
| Use-case fit | Demos, rough cuts, masters, stems | Released catalog from Distrokid/Tunecore/labels |
Supported formats
| Format | Notes |
|---|---|
| MP3 | Any bitrate, any ID3 version |
| WAV | Recommended for masters |
| FLAC | Recommended for masters |
| AIFF | Supported |
| M4A / AAC | Supported |
| OGG | Supported |
How to upload
Web dashboard
Confirm metadata
Patchline pre-fills title, artist, ISRC (if present), cover art (if
embedded). You confirm or edit.
Via Aria
Aria handles the upload + metadata confirmation in the chat. Best on Telegram for small files, web for larger ones.What gets extracted from your file
| Field | Source |
|---|---|
| Title | ID3 v2 TIT2 tag |
| Artist | ID3 v2 TPE1 tag |
| Album | ID3 v2 TALB tag |
| ISRC | ID3 v2 TSRC tag (if present) |
| Genre | ID3 v2 TCON tag |
| Track number | ID3 v2 TRCK tag |
| Year | ID3 v2 TYER / TDRC tag |
| Cover art | Embedded APIC frame (PNG / JPEG) |
| Duration | Read from file directly |
| Sample rate / bit depth | Read from file (WAV / FLAC) |
| BPM, key, mood, energy, valence, danceability, instruments, sonic genres | Runs via sonic analysis after upload (5 credits/track) |
Storage limits
| Tier | Storage cap |
|---|---|
| 1 GB | |
| 10 GB | |
| 100 GB | |
| 500 GB | |
| Unlimited |
Version control
Every upload to the same track ID creates a new version. Versions are listed in the catalog row → ⋯ → Versions.- Latest version is what plays, what sonic analysis runs on, what the storefront sells.
- Older versions are kept (full audit trail) until you explicitly delete them.
- Restore any version with one click.
Privacy & security
- Files are stored in encrypted, access-controlled cloud storage with version history.
- Only authorized users in your workspace can access playback or download links.
- Short-lived signed URLs are used for playback, analysis, and uploads.
- Patchline does not use your uploaded audio to train models.
Pricing
| Action | Credit cost |
|---|---|
| File upload itself | 0 credits (counts against lifetime upload cap) |
| Sonic analysis on upload | 5 credits/track (automatic) |
| Storage | Included in tier — no per-GB charge |
Related pages
- Catalog import — the URL-based path
- Sonic analysis — what runs after upload
- Storefront overview — sell what you upload
- Plans & credits — credit math
FAQ
Can I upload an album as a single file?
Can I upload an album as a single file?
Better to upload each track separately. Patchline treats each upload
as a single catalog entry, so an album-as-one-file becomes one row
instead of 12. If you have a 12-track album, upload 12 files.
What if my file has no ID3 metadata?
What if my file has no ID3 metadata?
The upload dialog prompts you to enter title, artist, etc. manually.
ISRC is optional — fill it in when you have it.
Does upload count against my catalog import limit?
Does upload count against my catalog import limit?
No. Uploads and imports are tracked separately. Upload cap (Free 3 /
Starter 25 / Pro 200 / Scale 1,000) is independent of catalog import
cap (Free 10 / Starter 100 / Pro 500).
Can I bulk-upload from a folder?
Can I bulk-upload from a folder?
Yes — drag a folder of files onto the upload zone. Patchline
processes them serially with a progress bar.
What about stems (multitrack)?
What about stems (multitrack)?
Upload them as separate tracks with naming convention
<song>-stem-<vocals|drums|bass|other>.wav. They’ll appear as
related rows. Stem separation tooling is in beta — see
Sonic analysis.What's the upload bandwidth requirement?
What's the upload bandwidth requirement?
Mostly governed by your internet connection. A 50 MB WAV on a
typical home connection (50 Mbps up) uploads in ~10s. Chunked
upload on Scale+ handles flaky connections gracefully.