<!--
{
  "documentType" : "article",
  "framework" : "AppleNewsFormat",
  "identifier" : "/documentation/AppleNews/adding-components",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Adding Components"
}
-->

# Adding Components

Learn the basics for adding components to your article.

## Discussion

An article can have many types of components, including text, images, social media posts, data tables, and so on. Each component is associated with both a `ComponentLayout` object that determines its placement in an article and a `ComponentStyle` object that determines its appearance.

If you like to treat a set of components as a group, add them to a [`Container`](/documentation/AppleNewsFormat/Container) component. See <doc://com.apple.applenews/documentation/AppleNews/nesting-components-in-an-article>. Otherwise, place individual components directly into the component’s array in [`ArticleDocument`](/documentation/AppleNewsFormat/ArticleDocument).

The following sample shows three components (a `title` component, an `author` component, and an `intro` component) in a `components` array.

```json
"components": [
    {
      "role": "title",
      "layout": "titleLayout",
      "text": "New Title",
      "textStyle": "titleStyle"
    },
    {
      "role": "author",
      "layout": "authorLayout",
      "text": "Angie Anders | Anders & Meyerson | March 20, 2018",
      "textStyle": "authorStyle"
    },
    {
       "role": "intro",
       "text": "The beginning was not nearly close enough and the ending had yet to be written."
    }
]
```

## See Also

  <doc://com.apple.applenews/documentation/AppleNews/creating-your-first-article>


---

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)