<!--
{
  "availability" : [
    "Apple News Format: 1.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppleNewsFormat",
  "identifier" : "/documentation/AppleNewsFormat/CollectionDisplay",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple News Format"
    ],
    "preciseIdentifier" : "data:news_format:CollectionDisplay"
  },
  "title" : "CollectionDisplay"
}
-->

# CollectionDisplay

An object used in any container component type to define how the collection of child components is presented.

```
object CollectionDisplay
```

## Discussion

This image shows a `CollectionDisplay` with a `distribution` property of `wide`.

![Screenshot of three images with whitespace equally distributed between them to fill the width of the available space.](images/com.apple.applenews/media-4099199@2x.png)

This image shows a `CollectionDisplay` with a `distribution` property of `narrow`.

![Screenshot of three images next to each other with a defined amount of whitespace between them.](images/com.apple.applenews/media-4099200@2x.png)

This object can be used in [`Header`](/documentation/AppleNewsFormat/Header), [`Container`](/documentation/AppleNewsFormat/Container), [`Section`](/documentation/AppleNewsFormat/Section), [`Chapter`](/documentation/AppleNewsFormat/Chapter), [`Aside`](/documentation/AppleNewsFormat/Aside), and [`ArticleLink`](/documentation/AppleNewsFormat/ArticleLink).

### Example

```json
{
  "components": [
    {
      "role": "container",
      "contentDisplay": {
        "type": "collection",
        "minimumWidth": 150,
        "gutter": "15",
        "rowSpacing": "30",
        "distribution": "wide"
      },
      "components": [
        {
          "role": "image",
          "URL": "bundle://gallery-02.jpg",
          "caption": "Coyotes are also seen in cities more often."
        },
        {
          "role": "image",
          "URL": "bundle://gallery-03.jpg",
          "explicitContent": true
        }
      ]
    }
  ]
}
```

---

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)