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

# ArticleLink

The container component for creating a link to an article.

```
object ArticleLink
```

## Discussion

Use the `ArticleLink` component to link a user to the article specified using the `articleIdentifier` property. If no `articleIdentifier` is provided, the component is assumed to be self referencing. Use [`ArticleThumbnail`](/documentation/AppleNewsFormat/ArticleThumbnail) and [`ArticleTitle`](/documentation/AppleNewsFormat/ArticleTitle) as child components instead of [`Image`](/documentation/AppleNewsFormat/Image) or [`Text`](/documentation/AppleNewsFormat/Text) to provide semantic value to the linked article. You can use these components to provide content, styling, and layout, like you do with any other Apple News Format component. Apple News automatically populates the content based on nested child elements. A [`ComponentAddition`](/documentation/AppleNewsFormat/ComponentAddition) is automatically added to the component to allow the user to navigate to the referenced article.

### Example

```json
{
  "components": [
    {
      "role": "article_link",
      "articleIdentifier": "https://apple.news/AT6kNQslCQy6EE4bF8hpOoQ",
      "components": [
        {
          "role": "article_thumbnail",
          "aspectRatio": 1,
          "fillMode": "cover",
          "verticalAlignment": "top"
        },
        {
          "role": "article_title"
        }
      ]
    }
  ]
}
```

## Relationships

### Inherits From

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

---

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)