<!--
{
  "availability" : [
    "iOS: 3.0.0 -",
    "iPadOS: 3.0.0 -",
    "macCatalyst: 13.1.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/MPMediaGrouping",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "Media Player"
    ],
    "preciseIdentifier" : "c:@E@MPMediaGrouping"
  },
  "title" : "MPMediaGrouping"
}
-->

# MPMediaGrouping

Keys used to configure a media query.

```
enum MPMediaGrouping
```

## Overview

The following code snippet shows how to apply a grouping key:

```swift
let everything = MPMediaQuery()
everything.groupingType = MPMediaGrouping.album
let collections = [everything]
```

After running these code lines, the `collections` array contains all the matched media items grouped and sorted according to album name.

To obtain a sorted list of songs, configure a media query with the `MPMediaGroupingTitle` key, or take advantage of the title key being the default for a media query. In either case, each obtained media item is, in effect, its own collection.

Collections sort according to the same rules used by iTunes on the desktop. This includes respecting the primary system language chosen by the user. The system ignores leading articles during sorting, including “A,” “An,” and “The” when using English, or “L’,” “La,” and “Le” when using French. If you need precise control over sorting, implement it in your application.

## Topics

### Media query keys

[`MPMediaGrouping.title`](/documentation/MediaPlayer/MPMediaGrouping/title)

Groups and sorts media item collections by title. For songs, for example, the title is the song name. This is the default grouping key.

[`MPMediaGrouping.album`](/documentation/MediaPlayer/MPMediaGrouping/album)

Groups and sorts media item collections by album, and sorts songs within an album by track order.

[`MPMediaGrouping.artist`](/documentation/MediaPlayer/MPMediaGrouping/artist)

Groups and sorts media item collections by performing artist.

[`MPMediaGrouping.albumArtist`](/documentation/MediaPlayer/MPMediaGrouping/albumArtist)

Groups and sorts media item collections by album artist (the primary performing artist for an album as a whole).

[`MPMediaGrouping.composer`](/documentation/MediaPlayer/MPMediaGrouping/composer)

Groups and sorts media item collections by composer.

[`MPMediaGrouping.genre`](/documentation/MediaPlayer/MPMediaGrouping/genre)

Groups and sorts media item collections by musical or film genre.

[`MPMediaGrouping.playlist`](/documentation/MediaPlayer/MPMediaGrouping/playlist)

Groups and sorts media item collections by playlist.

[`MPMediaGrouping.podcastTitle`](/documentation/MediaPlayer/MPMediaGrouping/podcastTitle)

Groups and sorts media item collections by podcast title.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)