---
title: Photo
framework: applenewsformat
role: symbol
role_heading: Object
path: applenewsformat/photo
---

# Photo

The component for including a photograph.

## Declaration

```data
object Photo
```

## Properties

URL: The URL of an image file. Image URLs can begin with http://, https://, or bundle://. If the image URL begins with bundle://, the image file must be in the same directory as the document. Encode image filenames as URLs. See Preparing Image, Video, Audio, Music, and ARKit Assets. role: Always photo for this component. accessibilityCaption: A caption that describes the photo.  VoiceOver uses this text. For more information about VoiceOver, see the Vision page in Accessibility. If you don’t provide accessibilityCaption, VoiceOver uses the caption value. additions: An array of ComponentLink objects you can use to create a ComponentLink, allowing a link to anywhere in News. anchor: An object that defines vertical alignment with another component. animation: An object that defines an animation you apply to the component. Use the none value for conditional design elements. Adding it here has no effect. behavior: An object that defines behavior for a component, like Parallax or Springy. Use the none value for conditional design elements. Adding it here has no effect. caption: A caption that describes the image. The article displays this text when the image is full screen, and VoiceOver uses this text if you don’t provide accessibilityCaption text. For more information about VoiceOver, see the Vision page in Accessibility. The caption text doesn’t appear in the main article view. To display a caption in the main article view, use the Caption component. conditional: An instance or array of component properties that you can apply conditionally, and the conditions that cause Apple News Format to apply them. explicitContent: A Boolean value that indicates the image may contain explicit content. hidden: A Boolean value that determines whether the component is hidden. identifier: An optional unique identifier for this component. If you use     identifier, it must be unique across the entire document. You need an identifier for your component if you want to anchor other components to it. layout: An inline ComponentLayout object that contains layout information, or a string reference to a ComponentLayout object that you define at the top level of the document. If you don’t define layout, size and position are based on various factors, such as the device type, the length of the content, and the role of this component. style: An inline ComponentStyle object that defines the appearance of this component, or a string reference to a ComponentStyle object that you define at the top level of the document. Use the none value for conditional design elements. Adding it here has no effect.

## Mentioned in

Preparing Image, Video, Audio, Music, and ARKit Assets Using HTML with Apple News Format

## Discussion

Discussion Use the photo component to display a photograph in an article. A photo component is optimized for displaying photographs. Other components are available for other types of images, such as Figure, Portrait, and Logo. See Preparing Image, Video, Audio, Music, and ARKit Assets. Example {   "components": [     {       "role": "title",       "text": "Apple News Format"     },     {       "role": "body",       "text": "Apple News Format allows publishers to craft beautiful editorial layouts. Galleries, audio, video, and fun interactions like animation make stories spring to life."     },     {       "role": "photo",       "URL": "bundle://image.jpg"     }   ] }

## Relationships

### Inherits From

- [Component](applenewsformat/component.md)

## See Also

### Related Documentation

- [Adding an Image and Captions](applenews/adding-an-image-and-captions.md)

### Images

- [Image](applenewsformat/image.md)
- [Figure](applenewsformat/figure.md)
- [Portrait](applenewsformat/portrait.md)
- [Logo](applenewsformat/logo.md)
- [ReplicaAdvertisement](applenewsformat/replicaadvertisement.md)
- [CaptionDescriptor](applenewsformat/captiondescriptor.md)