<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: -",
    "macOS: 15.0.0 -",
    "tvOS: 18.0.0 -",
    "visionOS: 2.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/URLRepresentableIntent",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "App Intents"
    ],
    "preciseIdentifier" : "s:10AppIntents22URLRepresentableIntentP"
  },
  "title" : "URLRepresentableIntent"
}
-->

# URLRepresentableIntent

An interface you add to an app intent type so the system can handle it like a universal link.

```
protocol URLRepresentableIntent : AppIntent
```

## Overview

If your app already supports universal links for content, use this protocol to express your app intent types as URLs.
When your app intent supports this protocol, the system can use the provided URL to process it. For example, if
your app intent supports this protocol and the [`OpenIntent`](/documentation/AppIntents/OpenIntent) protocol, the system opens the contained item
by sending the URL to your app’s URL handling code, allowing you to omit the [`perform()`](/documentation/AppIntents/AppIntent/perform()) method
in your type. Having a URL representation for your app intent also makes it easier to share its contents with Siri,
Shortcuts, and other system features.

> Important: This protocol requires your app to support universal links. You can’t use this protocol with a custom URL scheme
> or other approaches. For information about how to add support for universal links, see
> <doc://com.apple.documentation/documentation/Xcode/allowing-apps-and-websites-to-link-to-your-content>.

Construct URLs using static text and the content of your app intent’s properties. For information on how to
create the URL representation, see [`IntentURLRepresentation`](/documentation/AppIntents/IntentURLRepresentation).

---

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)