---
title: LinkAddition
framework: applenewsformat
role: symbol
role_heading: Object
path: applenewsformat/linkaddition
---

# LinkAddition

The addition object for defining links in text components that don’t use HTML or Markdown formatting.

## Declaration

```data
object LinkAddition
```

## Properties

rangeLength: The number of text characters to highlight as the link. rangeStart: The starting character index for the link addition. A range starts at 0 for the first character. If you specify rangeStart, you must also specify rangeLength. type: The type of addition. Use link. URL: The URL to open when a person interacts with the range of text specified in the addition.

## Discussion

Discussion Use a Link addition to add a link in a text component. You can link to an anchor in the same document, to another document in News, or to an external site. Example {   "components": [     {       "role": "body",       "text": "This is an example of a link addition",       "additions": [         {           "type": "link",           "URL": "http://www.apple.com",           "rangeStart": 0,           "rangeLength": 20         }       ]     }   ] }

## Relationships

### Inherits From

- [Addition](applenewsformat/addition.md)

## See Also

### Links

- [ComponentLink](applenewsformat/componentlink.md)
- [Addition](applenewsformat/addition.md)
- [ComponentAddition](applenewsformat/componentaddition.md)
- [SupportedURLs](applenewsformat/supportedurls.md)
- [SupportedInternalURLs](applenewsformat/supportedinternalurls.md)