Groups
Groups are how you organize collections for rotation. Each group is a named pool of collections with its own selection rules.
For example, you might have a "Holiday" group that's only active in December, a "New Releases" group that always gets at least 1 pick, and a "Deep Cuts" group with lower priority.
Group Ordering
The order of your groups matters, as it controls both how collections appear on the Plex homescreen and which groups get processed first during rotation (for the Random and LRU strategies).
Reorder groups by dragging them on the Groups page. Collections from higher-ordered groups appear first on the homescreen, and those groups are processed first during rotation, meaning they get to pick their collections before lower groups get to.
When using the Weighted strategy, group processing order is determined by weight instead (see Strategies below). Display order still controls homescreen positioning regardless of strategy.
Group Settings
| Setting | Description |
|---|---|
| Name | Display name for the group |
| Enabled | Toggle the group on/off without deleting it |
| Min Picks | Minimum collections to select from this group per rotation |
| Max Picks | Maximum collections to select from this group per rotation |
| Weight | Relative priority when using the weighted strategy (higher = processed first) |
| Min Gap Rotations | How many rotations must pass before a collection from this group can be featured again |
| Collections | The collection names that belong to this group |
| Display Order | Controls homescreen position and processing order — reorder by dragging groups on the Groups page |
| Date Range | Optional - restrict the group to a date window (e.g., Nov 20 – Dec 26 for holiday collections) |
Visibility Settings
Each group also controls how its collections appear on Plex:
- Home - Show on the admin's homescreen
- Shared - Show on shared users' homescreens
- Recommended - Show in the Library Recommended section
This lets you, for example, show curated collections to shared users while keeping niche ones admin-only.
Selection Strategies
The strategy controls how groups are ordered and how collections are picked within each group.
Random
Groups are processed in display order. Collections within each group are selected randomly. This is the simplest option- good variety, no special prioritization.
Weighted
Groups are sorted by weight setting (larger number = first), so higher-priority groups get their picks before lower-priority ones. Collections within each group are still selected randomly. Use this when you want certain categories to always take priority (e.g., "Featured" before "Deep Cuts").
Different collection selection strategies (alphabetical, manually set order, etc.) are currently in the works for a future release!
Least Recently Used (LRU)
Groups are processed in display order. Collections are selected based on how recently they were featured - those that haven't appeared in the longest time get priority. This ensures fair rotation across your entire library over time.
All three strategies respect the min_gap_rotations setting. Even with random selection, a collection won't appear again until the gap threshold is met.