Shortlist
Guides
How to do the things people actually want to do with Shortlist, from changing how often a row refreshes to sending missing films to Radarr.
Eight short pages instead of one long one. If you know what you want to do, start here.
What do you want to do?
| I want to… | Go to |
|---|---|
| Work out what a page in the app is for | The web interface |
| Give someone a different kind of row | Rows and templates |
| Name a row after the film that inspired it | Naming a row |
| Change the order titles appear in | The order titles appear in |
| Move a row to the top of the shelf | Row placement |
| Give a row its own artwork | Row posters |
| Change where the suggestions come from | What goes in a row |
| Stop one film skewing someone’s picks | Blocking a seed |
| Change how often a row refreshes | Schedules and runs |
| Use AI, or keep it cheap | AI and cost |
| Send missing films and shows to Radarr or Sonarr | Requests |
| Find out why a row didn’t turn up | Troubleshooting |
| Work out what’s wrong, or file a bug report | Have an issue? |
| Know what’s in a backup | Backups |
| Put Shortlist on the internet safely | Putting it on the internet |
The pages
| Page | What’s in it |
|---|---|
| The web interface | What every page does, and what each dashboard figure means |
| Rows and templates | Starting from a template, naming, ordering, where a row shows, posters |
| What goes in a row | Recommendation sources, rebuild cadence, per-row and per-person overrides |
| Schedules and runs | Each row’s own schedule, custom schedules, the jobs worth knowing about |
| AI and cost | What AI does, which search backend to pick, how to keep the bill down |
| Requests (Radarr and Sonarr) | Setting it up, the approval inbox, guardrails, why a title is still waiting |
| Troubleshooting and backups | The common failures, and what a backup does and doesn’t hold |
| Putting it on the internet | TLS, proxies, the API token, and what’s in /config/backups |
New here? Getting started covers the install and the setup wizard first. Looking for a specific setting or API endpoint? That’s Reference.
Another tool keeps moving your rows
Agregarr, Kometa and similar tools reorder the same Plex Recommended shelf Shortlist does, so rows can appear to shuffle between runs. Both sides can be told to leave the other alone.
In Agregarr, put shortlist in Settings → General → Exclude from Ordering (Plex Label). That one
word covers every Shortlist row: the field matches a label exactly OR as a prefix followed by _, so
it catches the constant shortlist label and each person’s shortlist_<name> one. It keeps working
as people join and leave, and needs no updating.
That field is newer than Agregarr’s v2.9.1 release — at the time of writing it is on the maintained
fork’s :develop image (bitr8/agregarr:develop).
Shortlist’s own side is Settings → Row placement, which decides where it puts rows and whether it manages shelf order at all — turning that off leaves the order entirely to the other tool.
Edit this page on GitHub