# EntityURLRepresentation The type that provides the URL for an app entity. ``` struct EntityURLRepresentation where Entity : AppEntity ``` ## Overview If you adopt the [`URLRepresentableEntity`](/documentation/AppIntents/URLRepresentableEntity) protocol in an app entity, use this type to build the URL for your entity. Construct the type as a Swift string that contains characters suitable for use in a URL. To incorporate content from your app entity’s properties into the URL, include a key path to the property in your string. The following example shows an app entity that represents a specific inventory item. Before returning the URL, this type replaces the `\(\.$contentID)` key path with the value in the `contentID` property. ```swift struct MyAppData: AppEntity, URLRepresentableEntity { static let defaultQuery = MyAppDataQuery() @Property(title: "Content ID") var contentID: String static var urlRepresentation = URLRepresentation("https://example.com/note=\(.$contentID)") } ``` Make sure the properties you include in your URL representation contain a URL-friendly type. The system automatically converts properties of type , , and to values suitable for inclusion in a URL. To incorporate other types, implement the [`CustomURLRepresentationParameterConvertible`](/documentation/AppIntents/CustomURLRepresentationParameterConvertible) protocol in the type. ## Topics ### Initializers [`init(String)`](/documentation/AppIntents/EntityURLRepresentation/init(_:)) Creates a URL representation for an app entity using the provided Swift string. ## Relationships ### Conforms To [`ExpressibleByStringLiteral`](/documentation/Swift/ExpressibleByStringLiteral) [`ExpressibleByExtendedGraphemeClusterLiteral`](/documentation/Swift/ExpressibleByExtendedGraphemeClusterLiteral) [`ExpressibleByUnicodeScalarLiteral`](/documentation/Swift/ExpressibleByUnicodeScalarLiteral) [`ExpressibleByStringInterpolation`](/documentation/Swift/ExpressibleByStringInterpolation) --- Copyright © 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)