Media collections

Use media collections to group media items that belong together. For example, a video playlist, a sermon series, a music album, or a book series can all be modeled as media collections.

Media collections appear on a media item’s details page, allowing users to quickly navigate to other items in the same collection. They can also be used to generate a gallery of media items on the homepage.

Here is an example of a media collection:

src/content/media-collections/sermon-series-1.json

{
  "label": {
    "en": "Sermon Series 1"
  },
  "mediaItems": ["sermon-1--en", "sermon-2--en"]
}

Reference

Media collections have these properties:

label

type: object
example: { "en": "Sermon Series 1" }
required: true

The name of the media collection. Provide a locale map keyed by your configured site languages.

mediaItems

type: string[]
example: ["sermon-1--en", "sermon-2--en"]
required: false

The identifiers of the media items contained in the collection. The order of this array defines the order shown on media item details pages and collection-based queries.