Content

Music suggestions

Personal shelves built from what each listener plays

Music suggestions gives every signed-in listener their own shelves of music, such as On repeat, Because you listened to … and Artists you might like. The shelves are built in the background from what each listener plays, follows, likes and skips. You don't pick anything by hand. You switch the feature on, choose which shelves to use and where they appear, and optionally connect outside sources of similar-artist data.

Beta. Still developing
Music suggestions is a beta feature. Test it on your own site before you rely on it, and expect minor or major changes in future

How it works

The system works in three stages:

  • Collect. Plays, follows, likes, playlist adds, dislikes and early skips are recorded as people use your site.
  • Build. A background cron job called Content suggestions works out each listener's shelves on a schedule and stores them. No outside service is called while shelves are built. Similar-artist data from Last.fm or ListenBrainz is collected beforehand by a separate job (see Similar artists below).
  • Show. Pages only read the shelves that are already stored, so a suggestion shelf loads like any other widget. Just before a shelf is shown, items the listener has disliked since the last build are removed, and so are items they have played since then (where played items are hidden). A dislike or a new play therefore shows up straight away, without waiting for the next rebuild.
Without cron, nothing is built
Shelves are built only by the Content suggestions cron job, plus once when a listener finishes the get-started page. If your server's scheduler is not calling RKHM's cron runner, listeners never get shelves. See Server for setting up the cronjob.

Who sees suggestions

  • Signed-in listeners only. Nothing is built for guests, and a Suggestion widget shows nothing to them.
  • Listeners with some activity. A signed-in listener with no plays, follows, likes or playlist adds gets no shelves. This is deliberate: there is no "trending" or "popular" fallback, because every shelf starts from the listener's own history. For brand-new listeners, use the get-started page described below, and keep your regular content widgets on your pages.

Where shelves appear

PlaceWhat it showsGood to know
Suggestion widget (PageBuilder)The listener's next shelf, in shelf orderIt has its own Suggestion group in the widget list. It has no title or subtitle inputs, because each shelf brings its own title. It shows up to the widget's item limit (default 20) and respects the widget's role include/exclude. If a shelf has too few items, the widget moves on to the next shelf. It shows nothing to guests or to listeners without shelves
Library → For you tabEvery shelf, one row per shelf, up to 20 items eachThe tab only appears once the listener has at least one shelf. When Last.fm is in use, it ends with the "Powered by AudioScrobbler" credit (see Last.fm below)
Get-started page, last stepUp to 8 shelves built at that momentOnly for new listeners, and only if you switch the page on

You can place several Suggestion widgets on one page. Each one shows the next shelf in line, so three widgets show three different shelves without any per-widget setup.

What activity counts

For each listener, RKHM scores artists from their activity. The highest-scoring artists, up to 50, become that listener's top artists, and most shelves start from them.

ActivityPoints for the artist
Each play among the listener's last 2,000 track plays+1, or +2 if it was in the last 30 days
Following the artist+5
Liking one of the artist's tracks+3
Liking one of the artist's albums+4
Adding one of the artist's tracks to a playlist+1
Disliking one of the artist's tracks−3
Each early skip of one of the artist's tracks−0.5
  • An artist the listener has disliked, or whose score is 0 or less, is never a top artist.
  • A play is recorded once a track has played for a few seconds, the same way plays are counted elsewhere on your site.
  • An early skip means a signed-in listener stopped a music track or moved on between 2 and 29 seconds into it. If the same track is restarted in another session within 15 seconds, that is a source or quality switch and is not counted. Skip records are kept for 180 days and are deleted with the user.
  • Liked genres only affect the genre shelf (see Genre likes).

How shelves are built

Every Run every minutes, the Content suggestions job checks which listeners are due for a rebuild under your Rebuild by activity rules. It starts with the most recently online and handles up to Max users per run, within Max seconds per run. Anyone left over waits for the next run. For each listener it builds the enabled shelves in their Order, filtering as it goes:

  1. No repeats across shelves. If two shelves would show the same item, the shelf that comes first in Order keeps it.
  2. Disliked items are removed. This always applies.
  3. Already-played tracks are removed, but only on the discovery shelves (Recommended for you, Because you listened to, More from artists you love, Top genre picks) and only while Hide items the user has already played is on. A track counts as played if the listener has played it, or has skipped it early two or more times without liking it.
  4. Unplayable items are removed, but only while Only suggest playable items is on.
  5. The shelf is cut to Max items. If fewer than Min items are left, the shelf is not shown.

If one shelf fails to build, the listener keeps that shelf's previous version.

What counts as playable

  • A track is playable if it has a stored playable source.
  • When YouTube or SoundCloud is enabled as a music source on the Music Automation page, a track with a Spotify ID also counts as playable.
  • An album is playable if at least one of its tracks is. Artists always count as playable.
  • Playability is checked only when shelves are built, not again when they are shown.

Music-specific clean-ups

  • One copy of a song. Tracks by the same artist with the same title count as one song. Bracketed parts and " - …" endings are ignored, so "Song (Remix)" and "Song" are treated as the same song.
  • At most 2 tracks per artist on the discovery shelves.
  • An artist's best tracks. When a shelf needs tracks by an artist, it picks from that artist's 20 most played tracks on your site, then by Spotify popularity. With Only suggest playable items on, only playable tracks are used.
  • Daily rotation. The discovery shelves and Artists you might like shuffle their 60 best candidates, using the date and the listener to decide the shuffle. So a shelf changes from day to day when it is rebuilt, but it doesn't change randomly on every page view.

The eight shelves

ShelfWhat it showsIts own settings (default)Enabled / Order / Max items / Min itemsHides played tracks?
On repeatTracks the listener has played most recentlyPlayed in the last (days): 30; Minimum plays: 3on / 10 / 20 / 3No
New from your artistsAlbums and singles released in the last N days (up to today) by the listener's top artists and followed artists. If a single and an album have the same title, the album is shownReleased in the last (days): 30; Top artists to use: 10on / 20 / 20 / 1No
Recommended for youTracks by artists similar to the listener's top artists, scored across all of them. Artists the listener skipped early 3 or more times and never played are left outTop artists to use: 10on / 30 / 20 / 4Yes
Because you listened to …One shelf per top artist, with tracks by that artist's similar artistsMax shelves: 2on / 40 / 20 / 4Yes
More from artists you loveTracks by the listener's top artists that they haven't playedTop artists to use: 10on / 50 / 20 / 4Yes
Artists you might likeSimilar artists the listener doesn't follow, hasn't disliked, has never played and hasn't skipped 3 or more timesTop artists to use: 10on / 60 / 20 / 4Not applicable (shows artists)
Top genre picks (shown as "Top Genre picks for you")The listener's genres, ranked by their listening, with liked genres counting extra. For each genre it takes the 40 most popular artists and shows their best tracks. Genres come from artists, albums and played tracksMax shelves: 2; Minimum artists in genre: 2on / 70 / 20 / 4Yes
Forgotten favouritesTracks the listener has played 5 or more times, or liked, and hasn't played in the last 60 daysMinimum plays: 5; Not played for (days): 60on / 80 / 20 / 3No
  • Recommended for you, Because you listened to … and Artists you might like need similar-artist data. A top artist with no similar artists adds nothing to these shelves, and there is no fallback by genre. See Similar artists below.
  • "Because you listened to X" or "Because you follow X". The title uses "Because you follow X" whenever X is not among the listener's recent plays. This also happens when the interest in X came from a liked track or album or a playlist add, so the title can say "follow" for an artist the listener does not actually follow.
  • Forgotten favourites includes liked tracks the listener hasn't played in the last 60 days. That includes a track they liked recently but never played, so the shelf is not limited to music they have drifted away from.
  • New from your artists depends on albums having release dates.

Settings

All suggestion settings are on Admin area → Settings → User → Suggestions. The similar-artist sources are configured separately, on the Music Automation page (see Similar artists).

Suggestions

SettingDefaultTip shown in the admin area
EnabledOffTurns suggestions on or off. Shelves are built for signed-in users only and show up where a Suggestion widget is placed
Run every (minutes)60How often the cron job checks for users to rebuild. The rules below decide who gets rebuilt
Max users per run100The rest wait for the next run
Max seconds per run60Long runs hold up other cron jobs such as uploads and search indexing. Big sites can run it separately with solojob=suggestions
Hide items the user has already playedOnPlayed items are removed when shelves are built and again when they are shown. Some shelves always show played items
Only suggest playable itemsOnLeaves out items that have nothing to play

Shelves also appear in the Library For you tab, even if you don't place a Suggestion widget anywhere.

Get started

SettingDefaultTip shown in the admin area
Get started page for new listenersOffSigned-in users with no follows, no likes and fewer plays than below are taken once to a page where they pick genres and artists, from the home page, their profile or their library. Picked artists are followed and picked genres liked; from then on suggestions come from what they play. They can skip it. It is not shown when fewer than 12 artists have a cover
Not asked after (plays)5Users who have played this many tracks are not asked

Rebuild by activity

RuleLast online within (days)Rebuild every (hours)
116
2724
330168
Everyone else—Empty (never)

Keep the rules in increasing order. Listeners covered by Everyone else are not rebuilt while that field is empty. They are rebuilt once they come back and fall under one of the rules again.

One group per shelf

Each of the eight shelves has its own group with Enabled, Order, Max items and Min items, plus the shelf's own settings listed in the table above. The Order tip reads: "Lower numbers come first. Each Suggestion widget on a page shows the next shelf. If two shelves have the same item, the first one keeps it."

The tip on the similar-artist shelves mentions Last.fm and ListenBrainz "if enabled in Music settings". Those switches are on the Music Automation page. These shelves also use similar artists worked out from your own listeners, which the tip doesn't mention.

Dislike

While suggestions are switched on, listeners can dislike tracks and artists. Dislike (and Remove dislike to undo it) is in the item menu: right-click, long-press, or the "more" button on cards, rows, queue items and single pages. A dislike is private. There is no public counter.

  • A disliked track leaves every shelf straight away, including On repeat and Forgotten favourites. Endless play never picks it, and its artist loses 3 points. Disliking a track also removes the listener's like on it.
  • A disliked artist is never a top artist and never suggested. Their tracks and albums leave every shelf, and so do "Because you listened to …" shelves based on them. Endless play skips them, and they are left out of the get-started page.
  • Disliking an artist removes the follow, and following the artist again removes the dislike.
  • When a listener dislikes something from a shelf card, the card disappears from the page at once.
  • A dislike does not affect anything the listener starts on purpose, such as an album, a playlist, a search result or their own queue.
  • To undo a dislike, the listener uses the same menu entry. There is no list of disliked items.

Genre likes

While suggestions are switched on, genre pages get a Like button, and Like is also in a genre's item menu. Liked genres appear in the listener's library Likes tab. Each liked genre counts extra on the Top genre picks shelf, even if the listener hasn't played much in it yet.

The get-started page

The get-started page helps new listeners get shelves before they have any history. To use it, switch on both Suggestions and Get started page for new listeners. A listener is sent there when all of these are true:

  • They are signed in and have never finished or skipped the page.
  • They follow no artists and have no liked tracks, albums or genres.
  • They have played fewer tracks than Not asked after (plays).
  • Your site has at least 12 artists with tracks and a cover.
  • They are on the home page, their own profile or their library.

They are sent there once per browser session until they finish it or press Skip. Skip is final. With the feature off, the page address (/get_started) shows "Not found".

  1. Genres. Up to 24 genres with the most artists to choose from, each shown with three artist faces. This step only appears when at least 3 genres qualify.
  2. Artists. Up to 60 artists, most-followed first, then the most popular, with a search box. Each pick slides in up to 4 similar artists. At least one pick is required, and three or more is recommended.
  3. Your music is ready. Shows the shelves that were just built, with a Start listening button that opens the For you tab.

On small sites with 40 or fewer artists to choose from, every artist is shown on one screen, with no search and no genre step.

Picks are saved as real follows and genre likes, so they behave like any other follow or like afterwards. Admins get one notification for the whole set of picks, not one per artist. Shelves are built right away. If a picked artist has no similar artists yet, the listener is rebuilt again on the next cron run.

Endless play

When a listener starts a track from a Suggestion widget or the For you tab and their queue runs out, playback continues with their other suggested tracks in shelf order. That's up to 300 tracks across all shelves, minus tracks already in the queue. In every other case, endless play works as before (see Multimedia files (player)), except that disliked tracks and artists are never picked.

Similar artists

Three shelves depend on knowing which artists are similar: Recommended for you, Because you listened to … and Artists you might like. RKHM uses up to four sources. Each is stored separately, so the similar artists you pick yourself are never overwritten.

SourceWeightWhat it needs
Your own picks — Related artists in the artist editorHighestNothing
Last.fmHighYour own Last.fm API key
This site's listenersHighEnough real listeners on your site
ListenBrainzLowerA MusicBrainz ID for the artist, looked up automatically
  • Similar artists from Last.fm and ListenBrainz are matched to artists in your catalogue by MusicBrainz ID first, then by name. Up to 30 matches are kept per artist per source. Names that don't match any of your artists are skipped, unless Create missing artists is on.
  • Related artists added by a MusicBrainz cronjob with Get related artists (which can include band members and relatives) are treated as if you picked them yourself. See Music Automation.
  • Similar artists ranked higher by their source count for more. Results are added up across all of a listener's top artists, with their strongest top artists counting up to twice as much.

The Similar artists job

A cron job called Music Plugin - Similar artists collects this data. It is only listed while Suggestions → Enabled is on, so with Suggestions off nothing is fetched, even if Last.fm or ListenBrainz is switched on. Each run does three things in order, sharing one time budget (Max seconds per run):

  1. Early skips. Reads new playback-log entries and records early skips.
  2. This site's listeners. Once a day, it works out which artists your listeners enjoy together. If it runs out of time, it continues on the next run.
  3. Last.fm and ListenBrainz. These use the time that's left. Artists in recent plays and follows go first, most in demand first. An artist is fetched when it has never been fetched or its data is older than Refresh after (days), up to Artists per run. An artist counts as fetched even when nothing matched, so it is not asked again until that refresh period has passed.

Settings

The settings are on Admin area → Content → Music → Automation, in the Similar artists group after the Spotify, YouTube and SoundCloud groups. A field left empty uses its default, which the field shows as a placeholder.

SettingDefaultTip shown in the admin area
Use Last.fmOffGets similar artists from Last.fm for the suggestion shelves. You need your own Last.fm API key. The free Last.fm API is for non-commercial use only. Commercial sites need an agreement with Last.fm. Last.fm also asks for a credit (shown on the For you tab), allows up to 100 MB of stored data and requires deleting it when your agreement ends
Last.fm API keyEmptyGet one at last.fm/api/account/create
Hide Last.fm creditOffHides the "Powered by AudioScrobbler" line on the For you tab. Last.fm requires it, so only hide it if your agreement with them allows it
Delete Last.fm data(an action, not a saved setting)See Deleting Last.fm data below
Use ListenBrainzOffGets similar artists from ListenBrainz, no key needed. Artists are looked up on MusicBrainz first. If a name matches several artists, it is skipped. MusicBrainz asks commercial sites to become a supporter. ListenBrainz offers this through its test (labs) API, so it may change
ListenBrainz algorithmBuilt-in defaultLeave empty to use the default
Run every (minutes)30Default 30
Artists per run30Most played artists go first. Default 30
Max seconds per run40Cron jobs run one after another, so keep this low. Default 40
Refresh after (days)90—
Create missing artistsOffSimilar artists that are not in your catalogue are added from Spotify, only when the name matches exactly. Requires Spotify Full Automation. Their tracks are only playable if YouTube or SoundCloud automation is on
Missing artists to check per artist10—
Max new artists per run5—
Use this site's listenersOnFinds similar artists from what your own listeners play, follow and like: "people who listen to A also listen to B". No key and no outside call. It only stores a pair once enough listeners share it, so a small site may see nothing for a while. Runs once a day
Minimum shared listeners3Two artists are similar only if at least this many listeners play both
Plays to look at200000The latest plays read on each pass
Keep API responsesOffSaves the Last.fm and ListenBrainz responses so the same artist is not requested again before its refresh date. Saved Last.fm data counts towards their 100 MB limit, about 40 KB per artist

In the admin area, the ListenBrainz tip links to MusicBrainz's supporter page (metabrainz.org/supporters). An invalid ListenBrainz algorithm value silently falls back to the default.

Last.fm

Check the Last.fm licence before switching it on
The free Last.fm API is for non-commercial use only. Commercial sites need an agreement with Last.fm. Last.fm also asks for a credit, allows up to 100 MB of stored data, and requires you to delete it when your agreement ends. RKHM shows the "Powered by AudioScrobbler" credit only at the bottom of the For you tab. Suggestion widgets on your pages don't show it, even though their shelves can include suggestions based on Last.fm. Check whether your Last.fm terms need attribution there too.

ListenBrainz and MusicBrainz IDs

ListenBrainz works from MusicBrainz IDs. If an artist already has one stored, it is used. Answers from Last.fm and ListenBrainz also fill in missing MusicBrainz IDs on matching artists. Otherwise RKHM searches MusicBrainz by name and only accepts a clear match. If several artists share the name and none clearly wins, or the ID already belongs to another of your artists, the artist is skipped as "no clear MusicBrainz match". ListenBrainz offers this data through its test (labs) API, so it may change without notice.

This site's listeners

This source needs no key and makes no outside call. Once a day it reads your latest activity (Plays to look at) along with recent follows and likes. A listener counts as a fan of an artist after 2 or more plays, a follow or a like. Disliked artists don't count, and at most 30 artists count per listener. An artist needs at least 5 listeners. Two artists become similar only when at least Minimum shared listeners listen to both, and more often than chance alone would explain. The best 30 per artist are kept and refreshed every 7 days.

Plays to look at counts all recent activity on your site, not only music plays. Radio, podcast, audiobook and beat plays, and other activity, are included in that number before music plays are picked out. On a site with mixed content, fewer music plays are read than the number suggests.

Create missing artists

With Create missing artists on, similar artists from Last.fm or ListenBrainz that aren't in your catalogue can be added from Spotify. For each of your artists, up to Missing artists to check per artist unmatched names are tried, and up to Max new artists per run artists are created. RKHM searches Spotify and only uses a result whose name matches exactly. It creates the artist with its Spotify ID, cover and genres.

Create missing artists can add more than the number you set
It does nothing, without any message, unless Spotify Full Automation is on, Spotify is not rate-limited and your Spotify keys work. Without that tool, only the artist is created. Tracks added this way have no stored source. They are only playable when YouTube or SoundCloud automation is on. Otherwise the artist can still appear under Artists you might like, but their tracks are not suggested. Spotify problems don't stop the rest of the similar-artist fetch.

Deleting Last.fm data

Ticking Delete Last.fm data and saving removes the similar-artist entries that came from Last.fm, the saved Last.fm responses, and the record of when each artist was last fetched from Last.fm. It only runs if the save succeeds. It does not remove:

  • MusicBrainz IDs that Last.fm answers filled in on your artists;
  • artists that Create missing artists added from Last.fm names;
  • similar artists you added yourself.

Switch Use Last.fm off first. Otherwise the job starts fetching again on its next run.

Admin notices

When a source stops working, admins are notified through admin notifications. The event is Similar artists source stopped, and it is on by default. The message reads "source stopped working: message. It will be tried again on the next run". It is sent at most once every 6 hours per source.

  • Last.fm: no API key ("Last.fm is on but has no API key"), an invalid key, a suspended key, or the rate limit.
  • ListenBrainz: too many requests, a token now being required ("ListenBrainz now requires a token"), or an unexpected response format (which suggests the ListenBrainz algorithm setting may need to change).

Any other error stops that source for the rest of the run without a notice. That includes a single network problem with Last.fm. It is tried again on the next run, and the error is shown in the Content sources panel.

Popularity and play counts

A cron job called Music Plugin - Popularity and play counts keeps album and artist play counts, artist like counts and popularity scores up to date. It checks every hour and does a full pass once a day. Popularity combines plays, likes, playlist adds (for tracks), followers (for artists) and Spotify popularity. The same job also works out the catalogue totals shown in the Content sources panel.

Monitoring

Content sources panel

The Content sources table on the Music page in the Stats section of the admin sidebar (Stats → Music) shows how every source that feeds your catalogue is doing. Its columns are Status, This period, Total, Last activity and What it does. It has rows for uploads, Spotify, cron jobs per API, YouTube and SoundCloud, plus these suggestion sources:

RowPossible status
Last.fm, ListenBrainz, Your listenersOff; "On, but Suggestions is off"; "No API key"; "Stopped time" with the last error; On
Create missing artists"On, but Spotify Full Automation is off" when that applies
Spotify"Rate-limited until …" when Spotify is limiting you

Run logs

Settings → Cronjob → Run logs shows each run of Content suggestions, Music Plugin - Similar artists and Music Plugin - Popularity and play counts.

Filters that help

The admin and widget filters can show you gaps in your catalogue. For tracks, use Has a stored source, Has genre (on the track, album or artist), Min plays and Longer/Shorter than (minutes). Albums have has-source, has-genre and minimum-plays filters, and artists have minimum plays.

Setup checklist

Your server's scheduler calls RKHM's cron runner, and Settings → Cronjob → Run logs shows recent runs
Optional but recommended: Spotify Full Automation on, and YouTube and/or SoundCloud enabled as a music source on the Music Automation page. This gives you more playable tracks and fills in genres
Settings → User → Suggestions → Enabled switched on, and the shelves and their Order reviewed
Music Automation → Similar artists: Use this site's listeners is already on. Optionally switch on ListenBrainz
Optionally switch on Last.fm and enter your API key, but only after checking the Last.fm licence
Optionally switch on Create missing artists, which needs Spotify Full Automation
One or more Suggestion widgets placed in PageBuilder, for example on your home page. Without them, shelves only appear in Library → For you
Optional: Get started page for new listeners switched on
After a few runs, the Content sources panel checked

Troubleshooting

What you seeWhat to check
Nobody has any shelvesIn this order: Suggestions is switched on; the listener is signed in; cron is running and Content suggestions appears in the run logs; the job has reached that listener yet (Max users per run, Max seconds per run and the activity rules all limit this); the listener has any activity; their shelves aren't all below Min items
A listener who was away never gets new shelvesListeners covered by Everyone else with an empty value are not rebuilt until they come back online
Recommended for you, Because you listened to … and Artists you might like are emptyThere is no similar-artist data for that listener's top artists. Check the Content sources panel. Common causes: Suggestions is off, so the Similar artists job isn't listed; Last.fm has no key; a source has stopped (look for a notice); your catalogue is small, so few similar artists match artists you have; ListenBrainz skipped artists with no clear MusicBrainz match; or This site's listeners hasn't stored anything yet
Last.fm is on but nothing is fetchedThe Similar artists job only runs while Suggestions → Enabled is on. Also check the API key
Many artists get no matchesSimilar artists are only kept when they match an artist in your catalogue, unless Create missing artists is on. An artist with no matches is not asked again until Refresh after (days) has passed
This site's listeners finds nothingIt needs at least 5 listeners per artist and Minimum shared listeners (default 3) in common, and it runs once a day. On a mixed-content site, Plays to look at also counts radio, podcast, audiobook and beat activity. A higher value reads further back
ListenBrainz stopped workingIt uses a test (labs) API that may change. Try the ListenBrainz algorithm setting, or switch ListenBrainz off
Similar-artist fetching is slow while MusicBrainz has problemsA failed MusicBrainz lookup is tried again on every run, with no notice and no panel entry, and it uses up the run's time. It clears up once MusicBrainz responds normally. You can also switch ListenBrainz off for a while
Last.fm stops partway through a runAny Last.fm error other than "not found" stops Last.fm for the rest of that run. You only get a notice for key, suspension and rate-limit errors. The panel shows "Stopped" with the last error, and it is tried again on the next run
No genre shelfToo few genres on artists, albums or played tracks, or fewer than 2 of the listener's top artists share a genre. Use the Has genre filter to find gaps
Shelves are short or empty with Only suggest playable items onTracks have no stored source and YouTube/SoundCloud automation is off. Use the Has a stored source filter
A track that can't be played is still on a shelfPlayability is only checked when shelves are built. It is corrected on that listener's next rebuild
Skipped tracks disappear, or come backTwo early skips hide a track from the discovery shelves only while Hide items the user has already played is on. With that setting off, skipped tracks can appear again. Early skips still lower the artist's score either way
"Because you follow X" for an artist the listener doesn't followThat title is used whenever X isn't among the listener's recent plays, even if the interest in X came from a like or a playlist add
Other cron jobs are delayedLower Max seconds per run on both the Suggestions page and Similar artists, or run the suggestions job separately with solojob=suggestions. The Similar artists job's three steps share one time budget, so the early-skip and listener steps can use all of it
Create missing artists does nothingSpotify Full Automation must be on, Spotify must not be rate-limited (look for "Rate-limited until …" on the Spotify row in Content sources), and your Spotify keys must work
The catalogue grows faster than Max new artists per runSwitch Create missing artists off if you want tight control
The get-started page never appearsBoth Suggestions and the get-started setting must be on. Your site needs at least 12 artists with tracks and a cover. The listener must have no follows or likes, fewer plays than the limit, and must not have finished or skipped it before. It is only offered on the home page, their profile or their library
The Last.fm credit isn't on my home pageThe credit is only shown on the For you tab. Suggestion widgets don't show it

Tips

  • Put the shelves you care about most first in Order. When two shelves share an item, the earlier one keeps it.
  • Place several Suggestion widgets on one page. Each one shows the next shelf.
  • Endless play continues from suggestions when a listener starts from a Suggestion widget or the For you tab.
  • Dislikes take effect straight away and are private. Encourage listeners to use them.
  • Genre Like buttons help listeners get a Top genre picks shelf sooner.
  • Check the Content sources panel to see the health of every source at a glance.
  • Keep API responses saves requests, but saved Last.fm data counts towards Last.fm's 100 MB limit (about 40 KB per artist).
  • Use the get-started page so new listeners get shelves before they have any history.