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.
How to Add a Collaborator
Section titled “How to Add a Collaborator”Use the collaborator controls for the selected track group or groups:
- Select one or more tracks in the grid
- Enter the collaborator’s name and email address
- Set master, publishing, and writer split values as needed
- 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.
Understanding Split Allocation
Section titled “Understanding Split Allocation”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 Total Allocation Display
Section titled “The Total Allocation Display”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.
Smart Default Splits
Section titled “Smart Default Splits”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%.
Input Helpers
Section titled “Input Helpers”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.
Using Auto Allocate
Section titled “Using Auto Allocate”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.
Managing Multiple Tracks
Section titled “Managing Multiple Tracks”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.
Validation and Protection
Section titled “Validation and Protection”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.
Related
Section titled “Related”- Splits & Allocation — understand master, publishing, and writer allocation values
- Sharing with Collaborators — control what collaborators can see and do
- Permissions — learn about role-based access levels
- Invitations — send and manage collaborator invitations
- Default Project Collaborators — use a saved roster, then assign collaborators to the tracks that need them
- Unsharing & Leaving — remove collaborators or leave a shared track