---
title: "Music Album Schema · Unhead"
canonical_url: "https://unhead.unjs.io/docs/typescript/schema-org/api/schema/music-album"
last_updated: "2026-10-08T18:48:26.230Z"
meta:
  description: "Use defineMusicAlbum() to describe an album, including its artist, tracks, release date, genre, ratings, and artwork."
  "og:description": "Use defineMusicAlbum() to describe an album, including its artist, tracks, release date, genre, ratings, and artwork."
  "og:title": "Music Album Schema · Unhead"
---

Home

`
Unhead on GitHub

Switch to TypeScriptSwitch to VueSwitch to ReactSwitch to SvelteSwitch to Solid.jsSwitch to AngularSwitch to Nuxt

**Schema**

# **Music Album Schema**

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/music-album.md)

## Schema.org MusicAlbum

**Type**: `defineMusicAlbum<T extends Record<string, any>>(input?: MusicAlbum & T)`

Describes a music album collection.

## Useful Links

- [**~~MusicAlbum - Schema.org~~**](https://schema.org/MusicAlbum)

## Required properties

- **name** `**string**`  
  The name of the album.

## Recommended Properties

- **byArtist** `**NodeRelations<Person | string>**`  
  The artist or artists on the album. Plain nested objects are resolved as [**~~Person~~**](https://unhead.unjs.io/docs/schema-org/api/schema/person) nodes. Use a nested `**defineMusicGroup()**` value when the artist is a group.
- **albumProductionType** `**string**`  
  The production type: "StudioAlbum", "LiveAlbum", "CompilationAlbum", "SoundtrackAlbum", etc.
- **albumReleaseType** `**string**`  
  The release type: "AlbumRelease", "SingleRelease", "EPRelease", etc.
- **track** `**NodeRelations<string>**`  
  Names or URLs of music recordings on the album. This field is currently passed through without a MusicRecording resolver.

## Defaults

- **@type**: `**MusicAlbum**`
- **@id**: `**${canonicalHost}#/schema/music-album/{n}**`

## Examples

### Minimal

```
defineMusicAlbum({
  name: 'Abbey Road',
  byArtist: 'The Beatles',
})
```

### Detailed example

```
defineMusicAlbum({
  name: 'Abbey Road',
  description: 'The eleventh studio album by The Beatles',
  url: 'https://example.com/albums/abbey-road',
  byArtist: {
    name: 'The Beatles',
  },
  albumProductionType: 'StudioAlbum',
  albumReleaseType: 'AlbumRelease',
  datePublished: new Date(1969, 8, 26),
  genre: ['Rock', 'Pop'],
  numTracks: 17,
  image: 'https://example.com/albums/abbey-road-cover.jpg',
  track: [
    'Come Together',
    'Something',
    // ... more tracks
  ],
})
```

## Types

```
export interface MusicAlbumSimple extends Thing {
  name: string
  description?: string
  url?: string
  byArtist?: NodeRelations<Person | string>
  track?: NodeRelations<string>
  albumProductionType?: string
  albumReleaseType?: string
  datePublished?: ResolvableDate
  genre?: string | string[]
  numTracks?: number
  image?: NodeRelations<string | ImageObject>
  aggregateRating?: NodeRelation<AggregateRating>
  review?: NodeRelations<Review>
}
```

## Related Schemas

- [**~~MusicGroup~~**](https://unhead.unjs.io/docs/schema-org/api/schema/music-group): Artist/band
- [**~~MusicRecording~~**](https://unhead.unjs.io/docs/schema-org/api/schema/music-recording): Album tracks
- [**~~Person~~**](https://unhead.unjs.io/docs/schema-org/api/schema/person): Artist

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/music-album.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/music-album.md)

**Did this page help you? **

[**Movie Schema** Use defineMovie() to add Movie structured data with ratings, cast, director, and release date.](https://unhead.unjs.io/docs/schema-org/api/schema/movie) [**Music Group Schema** Use defineMusicGroup() to describe a band or musical group, including its members, genre, dates, discography, and profiles.](https://unhead.unjs.io/docs/schema-org/api/schema/music-group)

**On this page **

- [Schema.org MusicAlbum](#schemaorg-musicalbum)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Defaults](#defaults)
- [Examples](#examples)
- [Types](#types)
- [Related Schemas](#related-schemas)