Scopes
Scopes provide Spotify users using third-party apps the confidence that only the information they choose to share will be shared, and nothing more.
Pre-requisites
Scopes are needed when implementing some of the authorization grant types. Make sure you have read the Authorization guide to understand the basics.
List of Scopes
- Images
- Spotify Connect
- Playback
- Playlists
- Follow
- Listening History
- Library
- Users
- Open Access
ugc-image-upload
| Description | Write access to user-provided images. | | Visible to users | Upload images to Spotify on your behalf. |
user-read-playback-state
| Description | Read access to a user’s player state. | | Visible to users | Read your currently playing content and Spotify Connect devices information. |
user-modify-playback-state
| Description | Write access to a user’s playback state | | Visible to users | Control playback on your Spotify clients and Spotify Connect devices. |
user-read-currently-playing
| Description | Read access to a user’s currently playing content. | | Visible to users | Read your currently playing content. |
app-remote-control
| Description |Remote control playback of Spotify. This scope is currently available to Spotify iOS and Android SDKs. | | Visible to users | Communicate with the Spotify app on your device. |
streaming
| Description | Control playback of a Spotify track. This scope is currently available to the Web Playback SDK. The user must have a Spotify Premium account. | | Visible to users | Play content and control playback on your other devices. |
playlist-read-private
| Description | Read access to user's private playlists. | | Visible to users | Access your private playlists. |
playlist-read-collaborative
| Description | Include collaborative playlists when requesting a user's playlists. | | Visible to users | Access your collaborative playlists. |
playlist-modify-private
| Description | Write access to a user's private playlists. | | Visible to users | Manage your private playlists.
playlist-modify-public
| Description | Write access to a user's public playlists.| | Visible to users | Manage your public playlists.|
user-follow-modify
| Description | Write/delete access to the list of artists and other users that the user follows. | | Visible to users | Manage who you are following. |
user-follow-read
| Description | Read access to the list of artists and other users that the user follows. | | Visible to users | Access your followers and who you are following. |
user-read-playback-position
| Description | Read access to a user’s playback position in a content. | | Visible to users | Read your position in content you have played. |
user-top-read
| Description | Read access to a user's top artists and tracks. | | Visible to users | Read your top artists and content. |
user-read-recently-played
| Description | Read access to a user’s recently played tracks. | | Visible to users | Access your recently played items. |
user-library-modify
| Description | Write/delete access to a user's "Your Music" library. | | Visible to users | Manage your saved content. |
user-library-read
| Description | Read access to a user's library. | | Visible to users | Access your saved content. |
user-read-email
| Description | Read access to user’s email address. | | Visible to users | Get your real email address. |
user-read-private
| Description | Read access to user’s subscription details (type of user account). | | Visible to users | Access your subscription details. |
user-soa-link
| Description | Link a partner user account to a Spotify user account |
user-soa-unlink
| Description | Unlink a partner user account from a Spotify account |
soa-manage-entitlements
| Description | Modify entitlements for linked users |
soa-manage-partner
| Description | Update partner information |
soa-create-partner
| Description | Create new partners, platform partners only |