Importing a Roster (Business)

Upload a CSV of artists and add your whole roster in one go with the Business plan import tool.

Roster import is available on the Business plan. It lets you add up to 50 artists at once from a spreadsheet instead of searching for each one individually.

CSV format

The file must be a plain CSV with a header row. Two columns are supported:

Column	Required	Notes
`name`	Yes	Artist display name
`spotify_id`	No	Spotify artist ID or full Spotify URL

If spotify_id is present, ArtistGuard looks up the artist directly on Spotify and skips the name search. If the column is omitted or a row has no ID, the name is used to find the closest match.

A minimal CSV looks like this:

name
Nova Waves
Skylar Haze
The Midnight Echo

A CSV with IDs looks like this:

name,spotify_id
Nova Waves,4exAMpL31dXXXXXXXXXXXX
Skylar Haze,4exAMpL32dXXXXXXXXXXXX
The Midnight Echo,4exAMpL33dXXXXXXXXXXXX

You can get a Spotify artist ID from the artist's Spotify profile URL. The ID is the string of characters at the end, for example 4exAMpL31dXXXXXXXXXXXX.

Step 1: open Import Roster

Go to Dashboard > Artists. On a Business plan account, an Import Roster button appears next to Add Artist in the top right. Click it.

Artists page showing both the Import Roster and Add Artist buttons in the top right

Step 2: upload your CSV

Drag and drop your file onto the upload area, or click Choose file to browse. The file is read locally in your browser and never uploaded as a raw file to the server.

Import Roster modal showing the drag-and-drop upload area and file picker button

Step 3: review resolved artists

After the file is read, ArtistGuard resolves each row against Spotify. A preview table shows:

Artist photo and name as it appears on Spotify
Follower count
Verified badge if the Spotify profile is verified
A warning icon if the name search returned no match

Rows that could not be matched are shown with an error. You can deselect any artist you do not want to import by unchecking the box on the left.

If your remaining slot count is lower than the number of selected artists, a warning appears at the bottom of the table telling you how many will be skipped due to the plan limit.

Import Roster preview table showing resolved artist photos, names, follower counts, and verified badges

Step 4: confirm the import

Click Proceed to go to the confirmation step. A summary shows the number of artists you are about to add.

Check the authorization box to confirm you are permitted to monitor these artists, then click Import Artists.

Import Roster confirmation step showing the artist count summary and authorization checkbox

Step 5: wait for initial scans

After you click Import Artists, the artists are added to your account right away. An initial scan runs in the background for each one that has not been scanned before. This collects the first snapshot of their profile, discography, and stats.

You can close the modal. The scans continue in the background. The Artists page refreshes automatically as each scan completes.

Artists page after import showing multiple artist cards with scanning indicators

Troubleshooting

Row shows "no match found" - the name did not match any Spotify artist. Add the spotify_id column for that row and try again.

Row shows "artist not found" - a Spotify ID was provided but Spotify returned no result. Check that the ID is correct and that the artist profile is still active.

Import button is missing - roster import requires the Business plan and a creator account role. Member accounts do not see the button.

PreviousSetting Up Your First Alert