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 Display Order and Random group order modes).
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 group order, processing order is determined by weight instead (see Group Order below). Display order still controls homescreen positioning regardless of group order.
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.
Group Order
The group order setting (configured in rotation settings) controls how groups are ordered for processing during rotation.
Display Order
Groups are processed in their configured display order. This is the default and simplest option.
Weighted
Groups are sorted by weight setting (larger number = first), so higher-priority groups get their picks before lower-priority ones. Use this when you want certain categories to always take priority (e.g., "Featured" before "Deep Cuts").
Random
Groups are processed in random order each rotation.
Collection Selection
Each group has its own collection_selection setting that controls how collections are picked from within the group.
Random
Collections are selected randomly from the group's pool. This is the default.
Least Recently Used (LRU)
Collections are selected based on how recently they were featured. Those that haven't appeared in the longest time get priority, ensuring fair rotation across all collections in the group over time.
Both selection modes respect the min_gap_rotations setting. A collection won't appear again until the gap threshold is met.