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

# BannerAdvertisement

The component for adding a full-width banner ad.

```
object BannerAdvertisement
```

## Discussion

`The BannerAdvertisement` object spans the full width of your display. A range of different banner heights are available depending on the availability of advertising content through Advertising Platforms.(An advertisement can appear inside a `Container` component only if the container is full-width.)

Keep these points in mind when including a banner advertisement in your article:

- Do not apply animations, scenes, or behaviors to advertisement components.
- Advertisements placed on the first “screen” of the article will not be rendered—with one exception: short articles that are only one screen can render one ad.
- The dimensions of visible areas vary with screen size and text size.
- If two or more advertising components are placed on the same screen, only the first will be rendered.
- Do not position advertising components immediately before or after images.
- For the `bannerType` property, choose only one value. The default value, `any`, allows any standard, double-height or large-banner advertisement to serve within a specific placement, based on availability.

For information about medium, fixed-sized advertisements, see [`MediumRectangleAdvertisement`](/documentation/AppleNewsFormat/MediumRectangleAdvertisement).

### Example

```json
{
  "components": [
    {
      "role": "banner_advertisement",
      "bannerType": "standard"
    }
  ]
}
```

## Relationships

### Inherits From

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

---

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)