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

# URLRepresentableEnum

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

```
protocol URLRepresentableEnum : AppEnum, CustomURLRepresentationParameterConvertible
```

## Overview

If your app already supports universal links for content, use this protocol to express your app enum types as URLs.
When your app enum supports this protocol, the system can use the provided URL to refer to the item. 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 value of your app enum. For more information on how to create the
URL representation, see [`EnumURLRepresentation`](/documentation/AppIntents/EnumURLRepresentation).

---

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)