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

# VideoFill

The object for adding a video background fill to a component.

```
object VideoFill
```

## Discussion

Use the `VideoFill` object to fill a component’s background with a video that starts playing automatically with no audio. You can specify whether the video scrolls or stays in one place when a person scrolls, what happens when the video ends, and the position of the video within the component. You can also supply an image to display when the video isn’t playing.

You can use this object in [`ComponentStyle`](/documentation/AppleNewsFormat/ComponentStyle).

### Example

```json
{
  "components": [
    {
      "role": "container",
      "style": "exampleComponentStyle",
      "layout": {
        "ignoreDocumentMargin": true,
        "minimumHeight": 150
      },
      "components": [
        {
          "role": "title",
          "text": "Season Preview: Nobody Saw This Coming",
          "anchor": {
            "targetAnchorPosition": "center"
          }
        }
      ]
    }
  ],
  "componentStyles": {
    "exampleComponentStyle": {
      "fill": {
        "type": "video",
        "URL": "https://example.com/hls/2014/fded0-1077dae/main.m3u8",
        "stillURL": "bundle://video-still.jpg",
        "fillMode": "cover",
        "verticalAlignment": "top"
      }
    }
  }
}
```

## Relationships

### Inherits From

[`Fill`](/documentation/AppleNewsFormat/Fill)

---

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)