# MediaStore.Audio.AlbumColumns

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# AlbumColumns

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/provider/MediaStore.Audio.AlbumColumns "View this page in Java")  

```
interface AlbumColumns
```

|--------------------------------------------------------------------------------------------------------------------------------------------------|
| [android.provider.MediaStore.Audio.AlbumColumns](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#) |

|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known Direct Subclasses [MediaStore.Audio.Albums](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.Albums),[MediaStore.Audio.Artists.Albums](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.Artists.Albums) |------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------| | [MediaStore.Audio.Albums](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.Albums)                 | Contains artists for audio files                                                          | | [MediaStore.Audio.Artists.Albums](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.Artists.Albums) | Sub-directory of each artist containing all albums on which a song by the artist appears. | |

Audio album metadata columns.

## Summary

|                                                                                                                                                                                                                                                                                                                                                                          Constants                                                                                                                                                                                                                                                                                                                                                                           ||
|----------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ALBUM](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ALBUM:kotlin.String) The album on which the audio file appears, if any This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object.                                                       |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ALBUM_ART](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ALBUM_ART:kotlin.String) Cached album art.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ALBUM_ID](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ALBUM_ID:kotlin.String) The id for the album This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object.                                                                              |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ALBUM_KEY](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ALBUM_KEY:kotlin.String) A non human readable key calculated from the ALBUM, used for searching, sorting and grouping This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object.    |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ARTIST](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ARTIST:kotlin.String) The name of the artist whose songs appear on this album.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ARTIST_ID](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ARTIST_ID:kotlin.String) The ID of the artist whose songs appear on this album.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [ARTIST_KEY](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#ARTIST_KEY:kotlin.String) A non human readable key calculated from the ARTIST, used for searching, sorting and grouping This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [FIRST_YEAR](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#FIRST_YEAR:kotlin.String) The year in which the earliest songs on this album were released.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [LAST_YEAR](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#LAST_YEAR:kotlin.String) The year in which the latest songs on this album were released.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NUMBER_OF_SONGS](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#NUMBER_OF_SONGS:kotlin.String) The number of songs on this album This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object.                                                   |
| static[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) | [NUMBER_OF_SONGS_FOR_ARTIST](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#NUMBER_OF_SONGS_FOR_ARTIST:kotlin.String) This column is available when getting album info via artist, and indicates the number of songs on the album by the given artist.                                                                                                                                                                                                                                                                                                                                                                |

## Constants

### ALBUM

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ALBUM: String
```

The album on which the audio file appears, if any  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_STRING](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_STRING:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "album"

### ALBUM_ART

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ALBUM_ART: String
```

**Deprecated:** *Apps may not have filesystem permissions to directly access this path. Instead of trying to open this path directly, apps should use[ContentResolver.loadThumbnail](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#loadThumbnail(android.net.Uri,%20android.util.Size,%20android.os.CancellationSignal))to gain access.*

Cached album art.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_STRING](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_STRING:kotlin.Int).  

    Value: "album_art"

### ALBUM_ID

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ALBUM_ID: String
```

The id for the album  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "album_id"

### ALBUM_KEY

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ALBUM_KEY: String
```

**Deprecated:** *These keys are generated using[java.util.Locale#ROOT](https://developer.android.com/reference/kotlin/java/util/Locale.html#ROOT:java.util.Locale), which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use[ContentResolver.QUERY_ARG_SQL_SORT_ORDER](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#QUERY_ARG_SQL_SORT_ORDER:kotlin.String)with`COLLATE LOCALIZED`, or[ContentResolver.QUERY_ARG_SORT_LOCALE](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#QUERY_ARG_SORT_LOCALE:kotlin.String).*

A non human readable key calculated from the ALBUM, used for searching, sorting and grouping  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_STRING](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_STRING:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "album_key"

**See Also**

- [android.provider.MediaStore.Audio#keyFor(String)](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio#keyFor(kotlin.String))  

### ARTIST

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ARTIST: String
```

The name of the artist whose songs appear on this album.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_STRING](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_STRING:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "artist"

### ARTIST_ID

Added in[API level 29](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ARTIST_ID: String
```

The ID of the artist whose songs appear on this album.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "artist_id"

### ARTIST_KEY

Added in[API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  
Deprecated in[API level 30](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val ARTIST_KEY: String
```

**Deprecated:** *These keys are generated using[java.util.Locale#ROOT](https://developer.android.com/reference/kotlin/java/util/Locale.html#ROOT:java.util.Locale), which means they don't reflect locale-specific sorting preferences. To apply locale-specific sorting preferences, use[ContentResolver.QUERY_ARG_SQL_SORT_ORDER](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#QUERY_ARG_SQL_SORT_ORDER:kotlin.String)with`COLLATE LOCALIZED`, or[ContentResolver.QUERY_ARG_SORT_LOCALE](https://developer.android.com/reference/kotlin/android/content/ContentResolver.html#QUERY_ARG_SORT_LOCALE:kotlin.String).*

A non human readable key calculated from the ARTIST, used for searching, sorting and grouping  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_STRING](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_STRING:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "artist_key"

**See Also**

- [android.provider.MediaStore.Audio#keyFor(String)](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio#keyFor(kotlin.String))  

### FIRST_YEAR

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val FIRST_YEAR: String
```

The year in which the earliest songs on this album were released. This will often be the same as[LAST_YEAR](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#LAST_YEAR:kotlin.String), but for compilation albums they might differ.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "minyear"

### LAST_YEAR

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val LAST_YEAR: String
```

The year in which the latest songs on this album were released. This will often be the same as[FIRST_YEAR](https://developer.android.com/reference/kotlin/android/provider/MediaStore.Audio.AlbumColumns#FIRST_YEAR:kotlin.String), but for compilation albums they might differ.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "maxyear"

### NUMBER_OF_SONGS

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val NUMBER_OF_SONGS: String
```

The number of songs on this album  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "numsongs"

### NUMBER_OF_SONGS_FOR_ARTIST

Added in[API level 3](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
static val NUMBER_OF_SONGS_FOR_ARTIST: String
```

This column is available when getting album info via artist, and indicates the number of songs on the album by the given artist.  
This constant represents a column name that can be used with a[android.content.ContentProvider](https://developer.android.com/reference/kotlin/android/content/ContentProvider.html#)through a[android.content.ContentValues](https://developer.android.com/reference/kotlin/android/content/ContentValues.html#)or[android.database.Cursor](https://developer.android.com/reference/kotlin/android/database/Cursor.html#)object. The values stored in this column are[Cursor#FIELD_TYPE_INTEGER](https://developer.android.com/reference/kotlin/android/database/Cursor.html#FIELD_TYPE_INTEGER:kotlin.Int), and are read-only and cannot be mutated.  

    Value: "numsongs_by_artist"