Overview
Upload your royalty statements to the Files section for automated processing. The system validates, extracts, and categorizes statement data, then matches revenue lines to your catalog and contracts.File Requirements
| Requirement | Value |
|---|---|
| Formats | Excel (.xlsx, .xls), CSV (.csv), Tab-delimited (.tab, .tsv, .txt), PDF (.pdf) |
| Minimum file size | 250 bytes |
| Maximum file size | 2 GB |
How to Upload
- Go to Statements → Files in the sidebar
- Click the Upload button in the toolbar, or drag and drop files into the main area
- Select one or more files from your computer
- Hold
Cmd(Mac) orCtrl(Windows) to select multiple files
- Hold
- All selected files are uploaded and queued for processing
Processing Pipeline
After upload, each statement goes through three main phases.Phase 1: Pre-Processing
During pre-processing, the system validates and analyzes your file before extraction begins.| Check | What It Does |
|---|---|
| File size validation | Ensures file is within size limits |
| File type validation | Confirms the file is a supported format |
| Format detection | Identifies structure (sheets, columns, tables) |
| Sheet analysis | Determines which sheets or pages contain revenue, summary, or cost data |
Phase 2: Extraction
Once pre-processing passes, AI extraction begins. The system:- Identifies statement format and data locations
- Extracts line-by-line data (assets, revenue, sources)
- Detects and normalizes currencies (transaction and royalty)
- Categorises revenue by type (streaming, download, sync, etc.) — see Data Categorisation for categories
- Extracts summary totals, balances, parties, and notes when present
Processing time depends on file size and complexity. Large spreadsheets or multi-page PDFs may take several minutes. You can monitor progress in the Files list.
Phase 3: Asset Matching
After extraction, the system matches statement lines to your catalog:- Recording statements: match by ISRC, UPC, asset title, and product
- Publishing statements: match by ISWC, work title, and writer
Processing Statuses
| Status | Description |
|---|---|
| Uploading | File transfer in progress |
| Queued | Waiting in the processing queue |
| Processing | Pre-processing or extraction in progress |
| Matching | Asset matching in progress |
| Review | Ready for user review |
| Complete | Fully processed |
| Error | Processing encountered an issue |
Managing Failed and Dismissed Statements
After uploading, statements that cannot be processed appear as Failed in the staging panel. You can dismiss individual failed statements or dismiss them all at once. Dismissed statements move to the Dismissed tab where you can review or permanently delete them.Dismiss All Failed
When the Failed filter is active in the staging panel, a Dismiss All button appears at the bottom of the list. This moves every failed statement to the Dismissed tab in one step.Open the staging panel
Go to Statements → Files and open the staging panel that shows uploaded statements and their statuses.
Delete All Dismissed
When the Dismissed filter is active in the staging panel, a Delete All button appears at the bottom of the list. This permanently removes all dismissed statements.Bulk Uploads
You can upload many statements in one go:- Select multiple files in the file picker, or drag and drop several files at once
- Each file is queued independently and processed in parallel where capacity allows
- Track progress via status in the Files list
- Use filters to narrow by status (e.g. Processing, Error) and bulk actions to edit or delete multiple statements
Related Documentation
Files Overview
List view, status, and confidence scores.
Statement Details
View extracted data and reprocess.
Reprocessing
Retry processing and use AI instructions.