---
title: "appEntityUIElements(_:)"
framework: swiftui
role: symbol
role_heading: Instance Method
path: "swiftui/view/appentityuielements(_:)"
---

# appEntityUIElements(_:)

Provides the system with additional context to make a custom view’s content discoverable by Apple Intelligence and Siri.

## Declaration

```swift
nonisolated func appEntityUIElements(_ provider: @escaping @MainActor (AppEntityUIElementsContext) -> [AppEntityUIElement]) -> some View

```

## Parameters

- `provider`: A closure to set up and return a list of elements that provide context to Apple Intelligence. The order of the returned elements isn’t relevant.

## Discussion

Discussion For standard SwiftUI views, you provide onscreen content and context to Apple Intelligence with the appEntityIdentifier(_:) modifier, making your app entities discoverable when your view appears on screen. To make content that appears in custom views to Apple Intelligence, use AppEntityUIElement structures that act as wrappers for your app entities to provide the system with additional context. The folowing example shows how a note taking app might provide context to Apple Intelligence for one of its custom views. Its app entity code describes a sticky note. The entity’s bounds property provides the system with additional spatial context, enabling it to better understand how a view and its content relate to other views on the screen. import AppIntents import SwiftUI

struct StickyNote: AppEntity {     var bounds: CGRect     let colorFill: Color

let id = UUID()     let displayRepresentation = DisplayRepresentation(title: "StickyNote")     static var typeDisplayRepresentation = TypeDisplayRepresentation(stringLiteral: "StickyNote")

static var defaultQuery = StickyNoteQuery()

init(bounds: CGRect, colorFill: Color) {         self.bounds = bounds         self.colorFill = colorFill     } }

struct StickyNoteQuery: EntityQuery {     func entities(for identifiers: [StickyNote.ID]) async throws -> [StickyNote] {         // Code to return the queried entities.     } } When drawing the view, the app uses the appEntityUIElements(_:) API to associate the view’s element with the app entity: struct NoteBoardView: View {     // A collection of app entities with information about the custom view's drawing behavir; for example the view's `.bounds`.     @State var stickyNotes: [StickyNote]

var body: some View {         Canvas { context, size in             stickyNotes.forEach { note in                 context.fill(                     Path(                         roundedRect: note.bounds,                         cornerSize: .zero                     ),                     with: .color(note.colorFill)                 )             }         }         .appEntityUIElements { context in                stickyNotes.compactMap { note in                    let includeNote = context.requests.contains { request in                        switch request {                            case .visible(let rect):                                return note.frame.intersects(rect)                            case .selected:                                return note.isSelected                            @unknown default:                                return false                        }                    }                    guard includeNote else {                        return nil                    }                    return AppEntityUIElement(                        identifier: EntityIdentifier(                            for: StickyNote.self,                            identifier: note.id                        ),                        bounds: note.frame,                        state: State(isSelected: note.isSelected)                    )                }         }     } } For more information, refer to doc:Making-onscreen-content-available-to-siri-and-apple-intelligence and App Intents.

## See Also

### App intents

- [appEntityIdentifier(_:)](swiftui/view/appentityidentifier(_:).md)
- [appEntityIdentifier(forSelectionType:identifier:)](swiftui/view/appentityidentifier(forselectiontype:identifier:).md)
- [onAppIntentExecution(_:perform:)](swiftui/view/onappintentexecution(_:perform:).md)
- [shortcutsLinkStyle(_:)](swiftui/view/shortcutslinkstyle(_:).md)
- [siriTipViewStyle(_:)](swiftui/view/siritipviewstyle(_:).md)