Welcome to our hub for partner guidelines and assets. We want to make it easy for you to integrate Spotify in your platform while respecting our brand and legal/licensing restrictions. These guidelines are meant to help any external developer integrating Spotify into their product while ensuring all Spotify users receive the same delightful user experience - no matter which platform they listen on.
By using these resources, you accept our Developer Terms of Service. Usage of these resources may also be covered by the Spotify End User Agreement and our Privacy Policy.
Attribution When does this apply?Content available through Spotify is owned by many different rights holders. If you use any Spotify metadata (including artist, album and track names, album artwork, and audio playback) it must always be accompanied by the Spotify brand.
Attribute with the Spotify logoTo comply with our licensing agreements, you must always attribute content from Spotify with the logo. In partner integrations, you should always use our full logo (icon + wordmark). We do allow using only our icon if it's featured as an app icon on the app screen of a device.
Spotify full logo and iconFull logo
Icon
Full logo and icon use must comply with our Logo & Color Guidelines.
Using our contentYES
The artwork must be kept in its original form, and its corners rounded according to the guidelines below.
NO
Don’t crop the artwork in any way.
NO
Don’t overlay images or text on top of the artwork. Don’t cover the artwork with playback controls.
NO
Don’t place your brand or logo on top of album artwork.
When does this apply?If you're using artwork and/or metadata provided by Spotify.
Follow these guidelines: For album and podcast artworkFor podcasts, two sets of metadata need to be supported:
We recommend using two lines in your layout for the title of the episode, since podcast episodes often have longer titles than music. The third line is then used for the podcast name.
For audiobooksFor audiobooks, two sets of metadata need to be supported and one is suggested.
Your layout should be able to accommodate these character counts:
If your app links to a user's Spotify account and there's a dedicated space to display Spotify content. Platforms that aggregate content from multiple audio providers must give Spotify fair treatment - anything made available to all other partners must be available to Spotify.
Follow these guidelines: Content provided by SpotifyYES
The full row (shelf) in the view should be dedicated to Spotify content.
NO
Spotify content should never be seated next to content from similar services.
Linking to Spotify When does this apply?On a platform where Spotify already exists. If you have built an integration on a platform where the Spotify client exists (mobile and desktop integrations), always link to the Spotify app. The Spotify app is the default playback mechanism. For full access to Spotify functionality, users should be directed to the Spotify application installed on the partner platform. If the app is not installed, the user should be directed to the app store so that they can install Spotify.
Using Spotify metadataIf you use any Spotify metadata (including artist, album and track names, album artwork and audio playback) it must always link back to the Spotify Service.
How to link to SpotifyThe link to Spotify must follow Spotify's attribution requirements and be accessible in your companion app.
Playing views When does this apply?When you're showing any playing views in your app.
Follow these guidelines:It is recommended that no play controls other than play/pause are provided in your app.
Why?Disabling and enabling play controls in response to restricted actions for Spotify Free may result in a confusing experience for the user. For example, the user may not understand why the skip back option has been disabled. Rather than explaining these restrictions to the user or creating a frustrating UX, we recommended you don't provide play controls.
If you choose to show play controls in your app, the following requirements need to be followed:
Handling Spotify Free restricted actions in your companion appWhen the user tries to perform a restricted action you may display this messaging.
Spotify Premium lets you play any track, podcast episode or audiobook, ad-free and with better audio quality. Go to spotify.com/premium to try it for free.
Handling playback actions for podcasts in your companion appIn all playback views where content from Spotify is playing (fullscreen views, widgets, bars, skipped song notifications) make sure to follow these guidelines:
DON'T
Crop artwork
Overlay images or text on top of artwork
Place the logo over artwork
DO
Extract artwork color for background (Android Palette). If not possible, use Spotify color #191414.
The Like feature should signal back to Spotify and the liked content must not be saved by the partner. When the user taps the + icon, they are liking a song or episode. The icon should change to its active state and show a message saying "Added to Liked Songs" or "New Episodes". If the user taps the + icon again to unlike the song, show a message saying "Removed from Liked Songs" or "Removed from New Episodes". The like action is always represented with the + icon and can be downloaded here:
Download Like iconStates for the Like icon
Showing entities When does this apply?In Spotify Free, for on-demand playback and shuffle play.
Follow these guidelinesFor Spotify Free, you have to support two types of layouts for tracklists when showing a playlist/album entity:
For on-demand playback, the user will be able to see and play all tracks in the playlist/album.
For shuffle play the user will only be able to see a content summary of the playlist/album and then start shuffle playback. The user can't pick a particular song to play, it will start playback in shuffle.
Displaying explicit contentUsing the Web API, your app can determine whether or not a track or a podcast episode is marked as containing explicit content. Consider using this information in your app to help users discover the content that is appropriate for them.
Apps that serve users in South Korea should follow local regulations governing explicit content. When displaying a tracklist or a piece of content to a user in South Korea, your app must display an explicit content badge next to the title of any explicit track or podcast episode. See the Web API reference documentation for more information about the explicit
field.
We are very proud of our logo. Follow these guidelines to ensure it always looks its best.
Our full logo is the combination of our logo icon and the wordmark.
Using the iconOur icon is a shorter version of our logo. Use the icon on its own only if you do not have enough room for the full logo or in cases when the Spotify brand has already been established. While the icon can exist without the wordmark, the wordmark should never exist without the icon.
Using the logoThe Spotify green logo, pictured top left, is our primary logo colorway, and it should only be used with black, white, and non-duotoned photography.
Which color logo to useThe Spotify green logo should only be used on a black or white background, for any other background you should use a monochrome logo.
The black logo should be used on light colored backgrounds. The white logo should be used on dark colored backgrounds.
LegibilityOur logo should always be legible and impactful. Always apply the logo and the icon's exclusion zone to isolate the logo from competing visual elements such as a busy area of an image, low contrast areas where legibility is compromised, or on top of text or supporting graphics. The exclusion zone is equal to half the height of the icon (marked as × in the diagram).
Minimum sizeEstablishing a minimum size ensures that the impact and legibility of the logo aren't compromised.
The Spotify logo should never be smaller than 70px in digital or 20mm in print.
The Spotify icon should never be smaller than 21px in digital or 6mm in print.
Logo misuseIt's important that the appearance of the logo remains consistent. The logo should not be misinterpreted, modified, or added to. Its orientation, color, and composition should remain as indicated in this document — there are no exceptions.
NO
Don't rotate the logo
NO
Don't fill the lines of the logo
NO
Don't stretch or alter the shape of the logo
NO
Don't use the logo in a sentence or as a letter
NO
Don't use the logo to make new objects or shapes
NO
Don't place the logo in a busy area, or in low-contrast areas where legibility is compromised
Using our colorsWhile embracing a much more colorful language in our brand communications, Spotify Green is our resting color, used whenever Spotify's voice needs to be recognizable.
YES
Do get creative with surprising color combinations
YES
Do choose colors with high contrast to ensure accessibility
NO
Don't introduce new colors outside our brand palette
NO
Don't use over-saturated colors for CMYK printing
Logo and naming restrictions Naming your applicationIf you are registering your application with us (on the Dashboard page) you will need to enter the name of your app. This name will be used in communications to your app's users when you seek authorization to access their data. We have a few pointers to consider when naming your app:
The app name should not include 'Spotify' or be similar to 'Spotify' in sound or spelling. It shouldn't imply endorsement by Spotify, but suggesting to users that it is 'for Spotify' is acceptable.
Your application's logoYour logo should not include, or look similar to the Spotify logo or any of its brand elements (e.g. Spotify Green, the circle, and the waves). Don't incorporate Spotify's trademarks, in whole or in part, in the name of your company, product, application, service, or website.
Don't pair brandsDon't use the Spotify brand together with any other brand or in any co-branded communications. Pairing of brands is not permitted under our Developer Terms.
Fonts What font to use?We recommend you to use the default sans-serif font for the platform you are working on. Try commonly available defaults in this order:
For additional programming resources, check out Stack Overflow (tag: Spotify).
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4