<!--
{
  "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/URLRepresentableEntity",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "App Intents"
    ],
    "preciseIdentifier" : "s:10AppIntents22URLRepresentableEntityP"
  },
  "title" : "URLRepresentableEntity"
}
-->

# URLRepresentableEntity

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

```
protocol URLRepresentableEntity : AppEntity, CustomURLRepresentationParameterConvertible
```

## Overview

If your app already supports universal links for content, use this protocol to express your app entity types as URLs.
When your app entity supports this protocol, the system can use the provided URL to refer to the item. For example,
when an [`OpenIntent`](/documentation/AppIntents/OpenIntent) type contains the entity, the system can open the item by sending the entity’s URL to
your app’s URL handling code. Having a URL representation for your app entity also makes it easier to share the
contents of that entity 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 properties in your app entity. For information on how
to create the URL representation, see [`EntityURLRepresentation`](/documentation/AppIntents/EntityURLRepresentation).

---

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)