# Adding a Video Add a video component inside the header component. ## Discussion A `video` component allows the user to control playback and hear audio. **On this page, you’ll learn how to add a video component.**  ### Add a Video to the Header To add a video to your article, you simply add a `video` component to a `components` array. Here, you’ll add a `video` component to the `components` array in the `header` component. > Note: > Alternatively, to include a video that plays automatically as the header’s background, you can use a ``doc://com.apple.applenews/documentation/AppleNewsFormat/VideoFill``. With a video fill, playback and audio are disabled, but the video can automatically loop. With a video fill, but not a `video` component, you can also use a scene to affect how the opening section or chapter, including the video, comes into view. See . In , you downloaded a bundle called `News_Design_Tutorial_Advanced_Article_3` that contains a thumbnail image. Now, you’ll move that image into your working folder and use it as a thumbnail. 1. Move the `video-still.jpg` file from the `Desktop/News_Design_Tutorial_Advanced/News_Design_Tutorial_Advanced_Article_3` folder to the folder that contains your working `article.json` file. 2. In your working `article.json` file, delete the first section, including its `components` array. The code you are deleting begins with the opening brace (`{`) before `"role": "section",` and ends with a closing bracket, a closing brace, and a comma (`]},`). 3. Copy the example code . 4. Paste the code inside the top-level `components` array, after the opening bracket (`[`). Your code should look like the example code . After you make this change in your code, you can preview your working `article.json` file in News Preview to see the video. #### Header Component: Copy This Code ```json { "role": "header", "layout": "fullBleedLayout", "behavior": { "type": "parallax", "factor": 0.8 }, "components": [ { "role": "video", "layout": "fullBleedLayout", "URL": "http://podcasts.apple.com/resources/462787156.mp4", "stillURL": "bundle://video-still.jpg", "accessibilityCaption": "Sed ut pers piciatis unde omnis iste natus volup tatem accusantium dolor emque, totam rem aperiam." } ] }, ``` #### Header Component: Result Ellipses (`...`) indicate lines of code that have been omitted from this example. ```json { ... "components": [ { "role": "header", "layout": "fullBleedLayout", "behavior": { "type": "parallax", "factor": 0.8 }, "components": [ { "role": "video", "layout": "fullBleedLayout", "URL": "http://podcasts.apple.com/resources/462787156.mp4", "stillURL": "bundle://video-still.jpg", "accessibilityCaption": "Sed ut pers piciatis unde omnis iste natus volup tatem accusantium dolor emque, totam rem aperiam." } ] }, ... ], ... } ``` ### Previous ### Next ## See Also [`object Video`](/documentation/AppleNewsFormat/Video) The component for adding a video. --- Copyright © 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)