Skip to content

Adding Collaborators

Adding collaborators in The Library creates a validated assignment for one or more selected track groups. You can set master, publishing, and writer split values as part of that assignment. Split values are production metadata; confirm any rights or legal terms separately with the people involved.


Use the collaborator controls for the selected track group or groups:

  1. Select one or more tracks in the grid
  2. Enter the collaborator’s name and email address
  3. Set master, publishing, and writer split values as needed
  4. Save the assignment

The service validates the assignment for every target track group. A bulk request can report a mixture of successful and unsuccessful target assignments.


Every collaborator can have three independently stored split values:

  • Master split — the recording allocation value
  • Publishing split — the publishing allocation value
  • Writer split — the writing allocation value used by export workflows

Each value is validated independently for every target track group. An add or update is rejected when its projected aggregate total would exceed 100%.

The collaborator controls can show the combined allocation and remaining value:

  • Remaining allocation — the value still available for a split dimension
  • No allocation remaining — the current dimension has no remaining capacity

Treat the displayed total as a planning aid; the server validates the final projected values before persistence.


When you add a new collaborator, the system doesn’t just leave you with a blank form. It calculates a suggested split based on what’s already allocated.

The service can suggest an even share constrained by remaining allocation when you add a collaborator. You can replace a suggestion with values appropriate for the track.

Suggestions never intentionally push a split dimension above 100%.

As you type in the split fields, you’ll see helpful hints below each input:

  • “X% remaining” — tells you how much is left to allocate
  • “No allocation remaining” — shows in amber text when that split type is fully allocated

The inputs also have built-in maximums based on remaining allocation, so you can’t accidentally enter more than what’s available.


If you want to distribute splits evenly across all collaborators with one click, use the Auto allocate button in the top-right corner of the Collaborators widget.

Auto allocate:

  • Divides master and publishing splits evenly among the current collaborators
  • Rounds to two decimal places (e.g., 33.33%, 33.33%, 33.34% for three people)
  • Updates all collaborator rows immediately
  • Persists the updated split rows after the optimistic UI update

Auto allocate is handy when you’re adding a group of collaborators and want to start with a clean slate before fine-tuning individual percentages.


Select multiple tracks to add, update, or remove collaborators in one request. The service checks ownership, de-duplicates matching collaborators, validates the projected totals for each track group, and can return per-track outcomes.


The system protects you from overallocation at multiple levels:

In the interface, you’re blocked from saving if your changes would push any split total above 100%. You’ll see a clear error message explaining the issue, and you won’t be able to proceed until you adjust the values.

On the server, the same validation happens automatically. Even if something bypasses the interface checks, the backend won’t accept splits that exceed 100%. This ensures data integrity regardless of how changes are submitted.


  • Use auto allocate as a starting point — then review each split dimension before saving.

  • Check all three dimensions — master, publishing, and writer values may be different.

  • Use bulk assignment deliberately — check its per-track outcomes before assuming every selected track was updated.