# Components Understand the types of components that can make up an article. ## Discussion Components are some of the main objects you use to build your article, along with layouts and styles. Components hold the content of your article and are always in an array called `components`. Each component in your article has a function that is expressed by a property called `role`. For example, the value of the `role` property might be `title`, `body`, `pullquote`, or `heading`. A component’s role determines what type of component it is. That is, when a component’s `role` is `body`, that type of component is referred to as a `body` component. See . The following table gives you an overview of the components you can use to create an article in Apple News Format. |**Component category**|**Component types** | |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |Text |``doc://com.apple.applenews/documentation/AppleNewsFormat/Body``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Title``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Heading`` (heading1, heading2, heading3, heading4, heading5, heading6), ``doc://com.apple.applenews/documentation/AppleNewsFormat/ArticleTitle``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Intro``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Caption``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Author``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Byline``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Illustrator``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Photographer``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Quote``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/PullQuote``| |Images |``doc://com.apple.applenews/documentation/AppleNewsFormat/Image``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Photo``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Figure``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Portrait``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Logo``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/ArticleThumbnail`` | |Galleries and Mosaic |``doc://com.apple.applenews/documentation/AppleNewsFormat/Gallery``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Mosaic`` | |Audio and Video |``doc://com.apple.applenews/documentation/AppleNewsFormat/Audio``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/EmbedWebVideo``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Music``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Podcast``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Video`` | |Location |``doc://com.apple.applenews/documentation/AppleNewsFormat/Map``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Place`` | |Social Media |``doc://com.apple.applenews/documentation/AppleNewsFormat/FacebookPost``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Instagram``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/TikTok``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Tweet`` | |Tables |``doc://com.apple.applenews/documentation/AppleNewsFormat/DataTable``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/HTMLTable`` | |Advertisements |``doc://com.apple.applenews/documentation/AppleNewsFormat/ReplicaAdvertisement`` | |Article Structure |``doc://com.apple.applenews/documentation/AppleNewsFormat/Container``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Section``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Chapter``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Aside``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Header``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/Divider``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/ArticleLink``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/LinkButton`` | |Augmented Reality |``doc://com.apple.applenews/documentation/AppleNewsFormat/ARKit`` | > Note: Choosing the component `role` that best describes your content is important for better voice-over and for facilitating Siri suggestions. For example, instead of styling text in a `body` component to make it look like a heading, use a `heading` component for that text instead. ## Topics ### First Steps [`object Component`](/documentation/AppleNewsFormat/Component) Properties shared by all component types. ### Text [`object Body`](/documentation/AppleNewsFormat/Body) The component for adding body text. [`object Title`](/documentation/AppleNewsFormat/Title) The component for adding an article title. [`object Heading`](/documentation/AppleNewsFormat/Heading) The text component for adding a heading. [`object Intro`](/documentation/AppleNewsFormat/Intro) The component for adding introductory text. [`object Caption`](/documentation/AppleNewsFormat/Caption) The component for adding caption text. [`object Author`](/documentation/AppleNewsFormat/Author) The component for adding the name of the author. [`object Byline`](/documentation/AppleNewsFormat/Byline) The component for adding the publication date or contributor credits, especially for articles with multiple contributors. [`object Illustrator`](/documentation/AppleNewsFormat/Illustrator) The component for adding illustrator credit. [`object Photographer`](/documentation/AppleNewsFormat/Photographer) The component for adding a photographer credit. [`object Quote`](/documentation/AppleNewsFormat/Quote) The component for including a quote. [`object PullQuote`](/documentation/AppleNewsFormat/PullQuote) The component for including a pull quote. [`object Text`](/documentation/AppleNewsFormat/Text) Properties shared by all text component types. ### Images [`object Image`](/documentation/AppleNewsFormat/Image) The component for displaying JPEG, WebP, PNG, or GIF images. [`object Photo`](/documentation/AppleNewsFormat/Photo) The component for including a photograph. [`object Figure`](/documentation/AppleNewsFormat/Figure) The component for including a figure. [`object Portrait`](/documentation/AppleNewsFormat/Portrait) The component for including an image of a person. [`object Logo`](/documentation/AppleNewsFormat/Logo) The component for including a logo image. [`object ReplicaAdvertisement`](/documentation/AppleNewsFormat/ReplicaAdvertisement) The component for delivering digital versions of print advertisements. [`object CaptionDescriptor`](/documentation/AppleNewsFormat/CaptionDescriptor) The object you use in image components for displaying captions when the image is full-screen. ### Galleries and Mosaics [`object Gallery`](/documentation/AppleNewsFormat/Gallery) The component for displaying a sequence of images in a specific order as a horizontal strip. [`object Mosaic`](/documentation/AppleNewsFormat/Mosaic) The component for displaying a set of images as tiles in no particular order. [`object GalleryItem`](/documentation/AppleNewsFormat/GalleryItem) An object used in a gallery or mosaic component for displaying an individual image. ### Audio and Video [`object Audio`](/documentation/AppleNewsFormat/Audio) The component for adding a playable audio clip. [`object Music`](/documentation/AppleNewsFormat/Music) The component for adding a playable music file. [`object Podcast`](/documentation/AppleNewsFormat/Podcast) The component for adding a Podcast show or episode. [`object Video`](/documentation/AppleNewsFormat/Video) The component for adding a video. [`object EmbedWebVideo`](/documentation/AppleNewsFormat/EmbedWebVideo) The component for adding a web video from Dailymotion, Vimeo, or YouTube. ### Location [`object Map`](/documentation/AppleNewsFormat/Map) The component for adding a map. [`object MapItem`](/documentation/AppleNewsFormat/MapItem) An object used in a map component for specifying the location of a map pin. [`object MapSpan`](/documentation/AppleNewsFormat/MapSpan) An object used in a map or place component for defining the visible area of the map. [`object Place`](/documentation/AppleNewsFormat/Place) The component for adding a map with a specific point of interest. ### Social Media [`object Instagram`](/documentation/AppleNewsFormat/Instagram) The component for adding an Instagram post. [`object FacebookPost`](/documentation/AppleNewsFormat/FacebookPost) The component for adding a Facebook post. [`object TikTok`](/documentation/AppleNewsFormat/TikTok) The component for adding a TikTok post. [`object Tweet`](/documentation/AppleNewsFormat/Tweet) The component for adding a Tweet that was posted to Twitter. ### Augmented Reality [`object ARKit`](/documentation/AppleNewsFormat/ARKit) The component for adding an augmented reality (AR) experience to your article. ### Tables ### Advertisements [`object BannerAdvertisement`](/documentation/AppleNewsFormat/BannerAdvertisement) The component for adding a full-width banner ad. [`object MediumRectangleAdvertisement`](/documentation/AppleNewsFormat/MediumRectangleAdvertisement) The component for adding a medium, fixed-size rectangle ad. ### Article Structure [`object Header`](/documentation/AppleNewsFormat/Header) The component for defining the top area of an article, chapter, or section. [`object Container`](/documentation/AppleNewsFormat/Container) Properties shared by all container types. [`object Section`](/documentation/AppleNewsFormat/Section) The component for organizing an article into sections. [`object Chapter`](/documentation/AppleNewsFormat/Chapter) The component for organizing an article into chapters. [`object Aside`](/documentation/AppleNewsFormat/Aside) The component for setting apart content that is not directly related to the article, such as promotional content. [`object CollectionDisplay`](/documentation/AppleNewsFormat/CollectionDisplay) An object used in any container component type to define how the collection of child components is presented. [`object HorizontalStackDisplay`](/documentation/AppleNewsFormat/HorizontalStackDisplay) The object for displaying components side by side in a Container component. [`object FlexibleSpacer`](/documentation/AppleNewsFormat/FlexibleSpacer) The component for redistributing empty space inside a horizontal stack collection. [`object Divider`](/documentation/AppleNewsFormat/Divider) The component for defining a horizontal line to visually divide parts of your article. [`object ArticleLink`](/documentation/AppleNewsFormat/ArticleLink) The container component for creating a link to an article. [`string SupportedArticleIdentifier`](/documentation/AppleNewsFormat/SupportedArticleIdentifier) The patterns supported for article identifiers in UUID format. [`string PublisherArticleIdentifier`](/documentation/AppleNewsFormat/PublisherArticleIdentifier) The identifier provided by the publisher. [`object ArticleTitle`](/documentation/AppleNewsFormat/ArticleTitle) The component for displaying an article title in the ArticleLink component. [`object ArticleThumbnail`](/documentation/AppleNewsFormat/ArticleThumbnail) The component for displaying a thumbnail image with an article link. [`object LinkButton`](/documentation/AppleNewsFormat/LinkButton) The component for opening a link in a button. ### Animations [`object ComponentAnimation`](/documentation/AppleNewsFormat/ComponentAnimation) Properties that all types of animations share. [`object AppearAnimation`](/documentation/AppleNewsFormat/AppearAnimation) An animation type whereby a component appears on the screen. [`object FadeInAnimation`](/documentation/AppleNewsFormat/FadeInAnimation) The animation whereby a component fades into view. [`object MoveInAnimation`](/documentation/AppleNewsFormat/MoveInAnimation) The animation whereby a component moves in from the side of the screen. [`object ScaleFadeAnimation`](/documentation/AppleNewsFormat/ScaleFadeAnimation) The animation in which a component scales up and fades into view. ### Behaviors [`object Behavior`](/documentation/AppleNewsFormat/Behavior) Properties shared by all the behaviors you can use to affect how components react to device motion and scrolling. [`object BackgroundMotion`](/documentation/AppleNewsFormat/BackgroundMotion) The behavior whereby the background of a component moves in the opposite direction from the motion of the device. [`object BackgroundParallax`](/documentation/AppleNewsFormat/BackgroundParallax) The behavior whereby the background of a component moves slightly slower than a person’s scroll speed. [`object Motion`](/documentation/AppleNewsFormat/Motion) The behavior whereby a component reacts to the motion of the person’s device. [`object Parallax`](/documentation/AppleNewsFormat/Parallax) The behavior whereby a component moves at a speed different from the scroll speed. [`object Springy`](/documentation/AppleNewsFormat/Springy) The behavior whereby a component acts as if it’s on a short spring. ### Links [`object LinkAddition`](/documentation/AppleNewsFormat/LinkAddition) The addition object for defining links in text components that don’t use HTML or Markdown formatting. [`object ComponentLink`](/documentation/AppleNewsFormat/ComponentLink) The component addition object for making a component interactive and opening a link to another location in News. [`object Addition`](/documentation/AppleNewsFormat/Addition) Properties that all addition types share. [`object ComponentAddition`](/documentation/AppleNewsFormat/ComponentAddition) Properties that all types of component additions share. [`string SupportedURLs`](/documentation/AppleNewsFormat/SupportedURLs) Links that go to Apple News, other Apple apps, and external sites. [`string SupportedInternalURLs`](/documentation/AppleNewsFormat/SupportedInternalURLs) Links that go to Apple News and other Apple apps. --- 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)