# Spotify Code

> Source: https://docs.barcoder.ai/docs/standards/spotify-code
> research date 2026-06-03 · extracted at 2026-10-06
> Publisher: Barcoder — encyclopedia of QR, barcode and payment-code standards

Specifications:
- [Spotify Codes — official generator](https://www.spotifycodes.com/)
- [How to Use, Create, and Share Spotify Codes — Spotify Newsroom](https://newsroom.spotify.com/2025-08-11/how-to-use-create-and-share-spotify-codes/)

## Overview

A **Spotify Code** is a proprietary, scannable visual tag that links to any item addressable by a Spotify URI — a song, album, artist, playlist, profile, or branded page. Visually it is unlike a QR code: it consists of the Spotify wordmark/logo followed by a row of vertical bars of varying height that resemble an audio waveform <sup>[1][1]</sup><sup>[4][4]</sup>. Codes are decoded by the camera built into the Spotify mobile app's Search tab; once recognized, the app jumps directly to the linked content <sup>[2][2]</sup>.

## History

Spotify introduced Spotify Codes in **May 2017**, rolling the feature out globally across Android and iOS at a time when the service had more than 50 million paid subscribers <sup>[3][3]</sup><sup>[6][6]</sup>. The stated goal was to reduce friction in sharing music — replacing the multi-step process of copying and sending a link with a single scannable symbol that could be passed over social media, text, or printed on physical media such as flyers and billboards <sup>[3][3]</sup>. The feature remains active and officially supported as of 2025 <sup>[2][2]</sup>.

## Technical specification

Spotify has never published a formal specification; the following is drawn from third-party reverse-engineering analysis <sup>[4][4]</sup>:

- A Spotify Code contains **23 bars** total. The first and last bars act as start/stop markers, and a central bar serves as a reference axis against which the other bars' heights are measured <sup>[4][4]</sup>.
- Each data bar encodes a height value of **0–7 (8 levels = 3 bits)**, measured from the axis and rounded to the nearest step. Heights are mapped with **Gray code** rather than plain binary so that a one-step misread changes only one bit <sup>[4][4]</sup>.
- Excluding the fixed markers, the **20 remaining bars carry 60 raw bits**. After forward error correction (a Viterbi/convolutional decoder), this resolves to **45 bits**: **37 bits of media reference** plus 8 bits of checksum <sup>[4][4]</sup>.
- The 37-bit media reference corresponds to a **22-character alphanumeric** lookup token (`[A-Za-z0-9]`), which the client resolves to a full `spotify:<type>:<id>` URI <sup>[4][4]</sup>.
- The Spotify logo at the head of the code helps the scanner locate and orient the machine-readable region <sup>[4][4]</sup>.

Codes are rendered through Spotify's image service (`scannables.scdn.co`) and via the consumer generator at spotifycodes.com, where users paste a Spotify URI and customize bar color, background, and size <sup>[1][1]</sup><sup>[2][2]</sup>.

## Use cases

- Instant in-app sharing of songs, albums, playlists, artists, and profiles between users <sup>[3][3]</sup>.
- Print and out-of-home marketing: codes appear on flyers, billboards, posters, merchandise, and product packaging to drive listeners to specific tracks or branded playlists <sup>[3][3]</sup><sup>[5][5]</sup>.
- Branded/promotional pages for artists and labels <sup>[2][2]</sup>.

## Implementations

There is **no official open-source Spotify Code encoder**. Generation is performed only by Spotify's own services: the spotifycodes.com web tool and the `scannables.scdn.co` image endpoint <sup>[1][1]</sup><sup>[2][2]</sup>. Decoding is restricted to the official Spotify app camera. Several unofficial libraries replicate the format based on the reverse-engineering work cited above, but none are endorsed by Spotify.

## Comparison

Compared with a generic QR code, a Spotify Code is far lower in data capacity (it carries only a ~37-bit reference token, not arbitrary data) and is single-purpose, but it is visually distinctive and on-brand, which is the principal reason Spotify built a proprietary symbology rather than using QR. The waveform aesthetic doubles as a recognizable "this plays music" affordance, and the short media-reference design keeps codes compact and printable at small sizes <sup>[4][4]</sup>. The trade-off is total dependence on Spotify's lookup service and app for resolution.

## Fun facts

- The 22-character / 37-bit reference space allows on the order of 10^39 distinct codes, vastly more than Spotify's catalog will ever need <sup>[4][4]</sup>.
- Reverse engineers found Spotify applies bit-shuffling so that consecutive logical bits are spread across non-adjacent bars, improving robustness of the error-correction stage <sup>[4][4]</sup>.

## Status

**Active.** Officially supported and documented by Spotify as of 2025, scannable via the Spotify app's Search camera and generable through spotifycodes.com <sup>[2][2]</sup>.

## Sources

[1] [Spotify Codes — official generator](https://www.spotifycodes.com/) — Spotify, 2025
[2] [How to Use, Create, and Share Spotify Codes](https://newsroom.spotify.com/2025-08-11/how-to-use-create-and-share-spotify-codes/) — Spotify Newsroom, 2025
[3] [Spotify rolls out scannable bar codes to boost music sharing](https://www.marketingdive.com/news/spotify-rolls-out-scannable-bar-codes-to-boost-music-sharing/442172/) — Marketing Dive, 2017
[4] [Spotify Codes and How They Work](https://levelup.gitconnected.com/spotify-codes-and-how-they-work-664f4e4b8489) — Level Up Coding (Medium), 2019
[5] [Using Spotify's New Codes Creatively](https://www.hypebot.com/hypebot/2017/06/using-spotify-codes-creatively.html) — Hypebot, 2017
[6] [Scan these new QR-style Spotify Codes to instantly play a song](https://techcrunch.com/2017/05/05/spotify-codes/) — TechCrunch, 2017

[1]: https://www.spotifycodes.com/
[2]: https://newsroom.spotify.com/2025-08-11/how-to-use-create-and-share-spotify-codes/
[3]: https://www.marketingdive.com/news/spotify-rolls-out-scannable-bar-codes-to-boost-music-sharing/442172/
[4]: https://levelup.gitconnected.com/spotify-codes-and-how-they-work-664f4e4b8489
[5]: https://www.hypebot.com/hypebot/2017/06/using-spotify-codes-creatively.html
[6]: https://techcrunch.com/2017/05/05/spotify-codes/

## Deployments

_No country reports mention this standard by name._

## Regions / aggregations not mapped to a single country

- Universal
