<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 15.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 8.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MusicKit",
  "identifier" : "/documentation/MusicKit/MusicItemCollection",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "MusicKit"
    ],
    "preciseIdentifier" : "s:8MusicKit0A14ItemCollectionV"
  },
  "title" : "MusicItemCollection"
}
-->

# MusicItemCollection

A collection of music items.

```
struct MusicItemCollection<MusicItemType> where MusicItemType : MusicItem
```

## Topics

### Operators

[`static func += (inout MusicItemCollection<MusicItemType>, MusicItemCollection<MusicItemType>)`](/documentation/MusicKit/MusicItemCollection/+=(_:_:))

Appends contents of a collection representing a next batch,
in the right hand side, to the existing collection
on the left hand side.

### Initializers

[`init<S>(S)`](/documentation/MusicKit/MusicItemCollection/init(_:))

### Instance Properties

[`var hasNextBatch: Bool`](/documentation/MusicKit/MusicItemCollection/hasNextBatch)

A Boolean value that indicates whether the collection has information
that allows it to fetch a subsequent batch of items.

[`var title: String?`](/documentation/MusicKit/MusicItemCollection/title)

An optional title for the collection.

### Instance Methods

[`func nextBatch(limit: Int?) async throws -> MusicItemCollection<MusicItemType>?`](/documentation/MusicKit/MusicItemCollection/nextBatch(limit:)-432i0)

Fetches the next batch of items asynchronously.

[`func nextBatch(limit: Int?) async throws -> MusicItemCollection<MusicItemType>?`](/documentation/MusicKit/MusicItemCollection/nextBatch(limit:)-ywue)

Fetches the next batch of items asynchronously.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`Hashable`](/documentation/Swift/Hashable)

[`Sequence`](/documentation/Swift/Sequence)

[`RandomAccessCollection`](/documentation/Swift/RandomAccessCollection)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`ExpressibleByArrayLiteral`](/documentation/Swift/ExpressibleByArrayLiteral)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Encodable`](/documentation/Swift/Encodable)

[`Collection`](/documentation/Swift/Collection)

[`BidirectionalCollection`](/documentation/Swift/BidirectionalCollection)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Escapable`](/documentation/Swift/Escapable)

[`Copyable`](/documentation/Swift/Copyable)

[`Decodable`](/documentation/Swift/Decodable)

[`Sendable`](/documentation/Swift/Sendable)

---

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)