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

# SupportedURLs

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

```
string SupportedURLs
```

## Discussion

You can define the following Apple domain links for the `URL` property in [`Text`](/documentation/AppleNewsFormat/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`](/documentation/AppleNewsFormat/Metadata).
- A link to the iTunes Store, the App Store, Apple Books, Apple Music, or Apple Podcasts you create using a [link generator](https://tools.applemediaservices.com/app-store).
- 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`](/documentation/AppleNewsFormat/Text) components:

- A universal link. See [Universal Links for Developers](https://developer.apple.com/ios/universal-links/).
- 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>`.

---

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)