---
title: SupportedURLs
framework: applenewsformat
role: symbol
role_heading: Type
path: applenewsformat/supportedurls
---

# SupportedURLs

Links that go to Apple News, other Apple apps, and external sites.

## Declaration

```data
string SupportedURLs
```

## Discussion

Discussion You can define the following Apple domain links for the URL property in Text components: A link to an Apple News article. Begin each link with https://apple.news/. To link within the document, use an anchor link starting with #, followed by the component identifier to which you want to link. To link to a component in another article, you must include an Apple News URL with the # and component identifier after it; for example, https://apple.news/A5vHgPPmQSvuIxPjeXLTdGQ#TextComponent-1. A canonical link element associated with an Apple News article by its canonicalURL in Metadata. A link to the iTunes Store, the App Store, Apple Books, Apple Music, or Apple Podcasts you create using a link generator. A link to a ticker symbol in the Stocks app, using the URL format stocks://?symbol=ticker symbol; for example, stocks://?symbol=AAPL. A link to Apple Music with the format music:// or musics://. You can define the following external links for the URL property in Text components: A universal link. See Universal Links for Developers. A link to an external site. A link to an email address that begins with mailto:. A link to a hosted calendar that begins with webcal://</value>.

## See Also

### Links

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