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

# Component

Properties shared by all component types.

```
object Component
```

## Discussion

In Apple News Format, every component has a property named `role` that conveys the component’s semantic value and its function in the article. For example, a `role` property that has a value of `body` indicates a `body` component, which means that its content is part of the article’s body text. A component whose `role` property has a value of `photo` represents one of the images in the article.

> Important:
> Don’t use this object type directly. Instead, use objects (such as `author,` `title`, `figure`, and so on) that extend the `Component` object.

You can use this object in [`ArticleDocument`](/documentation/AppleNewsFormat/ArticleDocument) and [`Container`](/documentation/AppleNewsFormat/Container).

## Relationships

### Inherited By

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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)