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

# GalleryItem

An object used in a gallery or mosaic component for displaying an individual image.

```
object GalleryItem
```

## Discussion

Use an array of `GalleryItem` objects to define the individual items used in a gallery or mosaic component. When the user taps an image in a gallery or mosaic to see it full-screen (as shown in the following figure), the caption from the caption descriptor property is shown. Note that this is different from the [`Caption`](/documentation/AppleNewsFormat/Caption) component.

![Screenshot of a full screen gallery image with a caption.](images/com.apple.applenews/media-4085707@2x.png)

This object can be used in [`Gallery`](/documentation/AppleNewsFormat/Gallery) and [`Mosaic`](/documentation/AppleNewsFormat/Mosaic).

### Example

```json
{
  "components": [
    {
      "role": "gallery",
      "items": [
        {
          "URL": "bundle://gallery-01.jpg",
          "caption": "Thanks to the record drought, mountain lions have begun to descend from the peaks, sometimes into urban settings."
        },
        {
          "URL": "bundle://gallery-02.jpg",
          "caption": "Coyotes are also seen in cities more often."
        },
        {
          "URL": "bundle://gallery-03.jpg",
          "explicitContent": true
        }
      ]
    }
  ]
}
```

## See Also

  <doc://com.apple.applenews/documentation/AppleNews/adding-a-gallery-of-images>

  <doc://com.apple.applenews/documentation/AppleNews/adding-a-mosaic-of-images>


---

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)