How do groups work?
- For a user to see a track, the user and the track need share a group.
- A user must have at least one group but could be in many groups. By default, upon signup users are automatically added to the “Main Catalogue” group.
- For tracks, groups need to be applied at the release level, or at the label level. Groups cannot be applied directly to individual tracks.
- Groups cascade from releases & labels onto all tracks beneath them (all main + alt versions).
Types of group
There are three types of group: tier, client, and country. They function identically (see above) but may be used to distinguish some quite different use cases.
Examples of each are:
- Tier — Gold / Silver / Bronze ...and/or... Commercial / Non-commercial
- Client — BBC / Netflix / Apple
- Country — France / Germany / Croatia / Rest of world / Worldwide
The “Main Catalogue” group
Every new library is created with a “Main Catalogue” group. Unauthenticated users, see tracks and releases that are in this group.
By default:
- All users are added to “Main Catalogue” upon signup
- All releases are added to “Main Catalogue” upon ingestion
This flow works for the vast majority of use cases but may be modified if more subtle access privileges are needed.