> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openvinyl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Albums and pressings

> How 8.1 million vinyl pressings are grouped into 3.9 million albums, and what the IDs mean.

A **pressing** is one physical edition of a record: a specific country, label, catalog number, year and plant. *The Dark Side of the Moon* has 674 vinyl pressings. An **album** groups the pressings of the same work.

## Album IDs

The prefix tells you how the album was formed.

| Prefix | Example | Formed from | Albums |
| - | - | - | - |
| `m` | `m10362` | A Discogs master | 1.67M |
| `g` | `g10047636` | Open Vinyl's own group: pressings with the same artist and title and no Discogs master | 44k |
| `r` | `r880079` | A release with only one version | 2.2M |

`g` and `r` IDs use the lowest Discogs release ID in the group, so they stay stable across rebuilds unless the group itself changes.

## Pressing IDs

A pressing ID is the **Discogs release ID**, so `GET /v1/pressings/367104` is [discogs.com/release/367104](https://www.discogs.com/release/367104).

## How a pressing joins an album

Each pressing records how it was linked, with a confidence. `GET /v1/albums/{id}` shows the breakdown under `membership`.

| `album_link` | Meaning | Confidence |
| - | - | - |
| `discogs_master` | Discogs lists it under this master | 1.0 |
| `probable_master` | No master on Discogs, but the artist and title match exactly one master | 0.8 |
| `grouped` | Grouped with others that share artist and title, where no master exists | 0.8 |
| `own` | The only version | 1.0 |

"Various" and "Unknown Artist" releases are never grouped by title, since unrelated compilations share those names.

## Links to other catalogs

Albums carry IDs from other catalogs where a link exists:

* **MusicBrainz release group**: from MusicBrainz's own Discogs links, then Wikidata, then member pressings. `musicbrainz_release_group_source` says which.
* **Wikidata item** and **English Wikipedia** article.
* **Cover**: a Cover Art Archive front cover from one of the album's MusicBrainz releases.

```json theme={null}
"ids": {
  "discogs_master": 10362,
  "musicbrainz_release_group": "f5093c06-23e3-404f-aeaa-40f72885ee3a",
  "musicbrainz_release_group_source": "musicbrainz",
  "wikidata": "Q150901"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.