Content Onboarding

Register your media assets with the Sureel Registry. The foundation for attribution analysis, opt-in/opt-out management, and IP protection.

Contact Us

Prepare Media

Gather audio, lyrics, images & metadata

Select Method

Choose how to submit your content

Register

Upload content with rights declarations

Manage

Monitor, update & track attribution

What is Content Onboarding?

Content onboarding is how artists, labels, and publishers register their media assets with the Sureel Registry. It is the foundation for attribution analysis, opt-in/opt-out management, and IP protection. The process covers:

  • Preparing media: audio, lyrics, images and associated metadata
  • Choosing an onboarding method: Frontend, API, OpenPlay, CSV/JSON, or DDEX
  • Registering content: with rights declarations and training preferences
  • Post-onboarding management: ongoing uploads, monitoring, and attribution

Supported Media & Metadata

What you can onboard and the data we need to register it properly.

Supported Media Types

Audio

Formats: MP3, WAV

Examples: Songs, stems, instrumentals, a cappella

Lyrics

Formats: Text, time-synced

Examples: Song lyrics with optional timing data

Images

Formats: JPG, PNG

Examples: Album art, promotional images, artist photos

Required Metadata

These fields are mandatory for every asset you onboard.

Required

Title

The title of the track, composition, or media asset

Required

Creators

Artist, lyricist, and/or composer names associated with the work

Optional Identifiers

Providing these helps improve matching accuracy and rights tracking.

Optional

ISRC

International Standard Recording Code - unique identifier for sound recordings

Optional

ISWC

International Standard Musical Work Code - unique identifier for musical works

Optional

UPC

Universal Product Code - barcode identifier for the physical/digital release

Optional

Release Date

The original or planned release date of the work

Supplementary Metadata

Additional metadata that enriches your catalog and enables more precise attribution.

Rights Splits

Ownership percentages between contributors

Genre

Musical genre classification

Tempo / Key

BPM and musical key of the recording

Publishing Splits

Publishing ownership percentages

Onboarding Methods

Choose the method that best fits your catalog size, technical setup, and workflow.

MethodBest For
Frontend ReleaseIndividual artists or small catalogs
API IntegrationLarge catalogs / automation
OpenPlay IntegrationOpenPlay users
CSV / JSONSmall/medium catalogs
DDEXIndustry-standard workflows

The simplest way to onboard content. Use the Sureel web app to create a release, upload your media files, and fill in metadata through a guided form.

Steps

  1. Navigate to
  2. Enter your release metadata (title, artists, release date, etc.)
  3. Upload audio files (MP3 or WAV), cover art, and optional lyrics
  4. Set your rights declarations and AI training preferences
  5. Review and submit your release for processing

Best for:

Artists managing their own releases, small labels with a handful of releases, or anyone who prefers a visual interface over technical integration.

For programmatic access to content onboarding. Use the Sureel REST API to automate uploads, manage metadata, and handle large catalogs at scale.

Step 1: Authenticate

Obtain an access token using Auth0 client credentials:

bash
curl --request POST \
  --url https://sureel.eu.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id": "<Your-Client-Id>",
    "client_secret": "<Your-Client-Secret>",
    "audience": "https://api.sureel.ai",
    "grant_type": "client_credentials"
  }'

Step 2: Generate Upload URLs

Request signed upload URLs for your media files:

bash
curl -X POST https://api.sureel.ai/v1/files/generate-upload-urls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "files": [
      { "fileName": "track-01.wav", "contentType": "audio/wav" },
      { "fileName": "cover-art.jpg", "contentType": "image/jpeg" }
    ]
  }'

Step 3: Upload Files

Upload each file to its signed URL:

bash
# Upload file to the signed URL returned from generate-upload-urls
curl -X PUT "<signed-upload-url>" \
  --header 'Content-Type: audio/wav' \
  --data-binary @track-01.wav

Step 4: Create Collection

Create a collection (album/single/EP) with your uploaded files and metadata:

bash
curl -X POST https://api.sureel.ai/v1/ai/artist/upload-artwork \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "collectionName": "My Album",
    "releaseDate": "2025-06-15",
    "tracks": [
      {
        "trackTitle": "Track One",
        "isrc": "USRC12345678",
        "artists": ["Artist Name"],
        "labels": ["Label Name"],
        "genres": ["Electronic"],
        "fileId": "<file-id-from-upload>"
      }
    ],
    "coverArt": "<cover-file-id>",
    "aiInfluence": "Generated without AI"
  }'

Step 5: Verify

Check your collections to confirm the upload:

bash
# Check upload/processing status
curl https://api.sureel.ai/v1/ai/artist/collections \
  --header 'Authorization: Bearer <token>'

If you already use OpenPlay for your catalog management, Sureel offers a fully managed integration. Your existing catalog flows directly into the Sureel Registry with no additional work.

Steps

  1. Contact Sureel to set up your OpenPlay integration (info@sureel.ai)
  2. Select which OpenPlay content you want to register with Sureel
  3. Generate OpenPlay API keys to grant Sureel access to your catalog
  4. Your catalog is automatically synced to the Sureel Registry
  5. Ongoing updates are handled automatically, with no manual uploads needed

Fully Managed

The OpenPlay integration is fully managed by Sureel. Once configured, your catalog stays in sync automatically with no ongoing maintenance required.

Download a CSV or JSON template, populate it with your metadata, and upload it along with your media files. Ideal for catalogs where you have metadata in spreadsheets.

Steps

  1. Download the CSV or JSON template
  2. Populate the template with your catalog metadata (one row/object per track)
  3. Prepare your media files in a folder with filenames matching the template
  4. Send the completed template and media files to Sureel (info@sureel.ai)
  5. Sureel processes and ingests your catalog into the registry

Template downloads will be available soon. Contact us for the latest template files.

For organizations using the DDEX standard for digital supply chain metadata. Upload a ZIP archive containing DDEX-compliant XML metadata alongside your media files.

Steps

  1. Prepare your DDEX-compliant XML metadata files following the ERN (Electronic Release Notification) standard
  2. Package your XML metadata and media files into a ZIP archive
  3. Ensure file references in the XML match the actual filenames in the archive
  4. Send the ZIP archive to Sureel (info@sureel.ai)
  5. Sureel validates and ingests your DDEX submission into the registry

DDEX Standards Supported

We support ERN (Electronic Release Notification) for new releases. Contact us if you use other DDEX message types such as MLC (Musical Works Licensing) or DSR (Sales Reporting).

Contact for DDEX Setup

Label vs Publisher Requirements

Labels and publishers have different content types and metadata needs. Here's what to prepare for each.

AspectLabelsPublishers
Primary ContentFull tracks + optional stems (vocals, instrumentals, bass, drums)Composition data (song title, composers with IPI, publishing splits)
Required MetadataTitle, artists, ISRC, release date, label nameSong title, composers with IPI numbers, publishing splits, PRO affiliations
Supplementary DataGenre, tempo/key, album art, rights splitsISWC, territory rights, sub-publisher information
Preferred FormatsWAV or MP3 for audio; JPG/PNG for artworkMIDI, MusicXML, DDEX preferred over PDFs
Onboarding MethodsAll methods available (Frontend, API, CSV/JSON, DDEX, OpenPlay)API for bulk automation, DDEX, or CSV/JSON

For Labels

  • Full tracks + optional stems (vocals, instrumentals, bass, drums)
  • Core metadata: title, artists, ISRC, release date
  • Supplementary: genre, tempo/key, album art, rights splits

For Publishers

  • Composition data: song title, composers with IPI numbers
  • Publishing splits and PRO affiliations
  • Preferred formats: MIDI, MusicXML, DDEX (over PDFs)

Rights & Training Preferences

Declare your rights and control how your content is used in AI training and synthesis.

Rights Declarations

  • Master ownership and licensing terms
  • Territorial restrictions for distribution
  • Exclusive vs. non-exclusive rights declarations
  • Songwriter and composer credits with IPI numbers
  • Publishing splits between multiple parties
  • Mechanical and synchronization rights
  • Original work references and licensing
  • Derivative work classifications
  • Attribution requirements for source material
  • Name: stage name and legal name
  • Image: photos, album art, brand assets
  • Voice: spoken recordings, vocal stems, full tracks
  • Video: music videos, performances, interviews
  • Persona: biography, lyrics, social handles, interview transcripts

AI Training Preferences

Control whether and how your content is used for AI model training.

Opt-In for AI Training

Allow your content to be used for training AI models. When opted in, your content is eligible for AI training with full attribution tracking, ensuring you receive credit and compensation when your work influences AI outputs.

Opt-Out of AI Training

Prevent your content from being used in AI model training. Your assets are registered in the Do-Not-Train registry, and AI developers can check this registry before training to ensure compliance with your wishes.

Synthesis Rules

Define granular rules for how your content can be used in AI synthesis. Set attribution thresholds (minimum credit percentage), genre restrictions (e.g., only allow use in specific genres), and artist restrictions (exclude specific artists from shared attribution).

Knowledge Acquisition Ratio

The knowledge acquisition ratio measures how much of your original content's characteristics are absorbed by an AI model during training. A higher ratio means the model has learned more from your work, which directly impacts attribution percentages and compensation calculations.

Post-Onboarding

What happens after you upload your content, and how to manage it going forward.

Processing Pipeline

After your content is submitted, it goes through these stages:

1

Content Validation

Your uploaded media and metadata are validated for format compliance, completeness, and data integrity.

2

Secure Migration

Validated content is securely transferred to the Sureel Registry with encryption at rest and in transit.

3

Registry Indexing

Your content is fingerprinted and indexed in the 12M+ asset registry, enabling attribution analysis and rights tracking.

Ongoing Management

After onboarding, you can continue uploading new content and managing your catalog:

  • Scheduled API calls: Automate ongoing uploads with cron jobs or CI/CD pipelines
  • Manual uploads: Use the web app or CSV/JSON for ad-hoc additions
  • Metadata updates: Update rights, splits, and preferences via the API or web app

Explore Sureel Features

With your content in the registry, unlock the full power of Sureel: