<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -",
    "macOS: 27.0.0 -",
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/AppSchema/CalendarEntity/event",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "App Intents",
      "AppIntents"
    ],
    "preciseIdentifier" : "s:10AppIntents0A6SchemaV14CalendarEntityPAAE5eventQrvp"
  },
  "title" : "event"
}
-->

# event

An entity schema for an event.

```
var event: some AppSchemaEntity { get }
```

## Discussion

To make your app’s content available to Apple Intelligence,
conform your [`AppEntity`](/documentation/AppIntents/AppEntity) to a schema that describes your content to the system.
If your app’s functionality aligns with the `calendar` domain
and its content matches the `event` schema,
you can generate the properties and protocol conformance the schema requires
for your app entity implementation
with the `@AppEntity( .calendar.event)` Swift macro.
To make your app work with Siri,
see <doc://com.apple.documentation/documentation/AppIntents/apple-intelligence-and-siri-ai>.

The following example shows an app entity that conforms to the `event` schema:

```swift
@AppEntity(schema: .calendar.event)
struct EventEntity {
    // MARK: Static

    static let defaultQuery = EventEntityQuery()

    // MARK: Properties

    let id: <#Identifiable.ID#>

    var calendar: <#CalendarEntity#>
    var title: String
    var startDate: Date
    var endDate: Date
    var isAllDay: Bool
    var recurrence: Calendar.RecurrenceRule?
    var note: AttributedString?
    var travelTime: Duration?
    var location: <#EventLocation#>?
    var virtualLocation: URL?
    var status: <#EventEntityStatus#>?
    var alarms: [<#EventAlarm#>]
    var organizers: [IntentPerson]
    var attendees: [<#AttendeeEntity#>]

    var displayRepresentation: DisplayRepresentation {
        <#DisplayRepresentation#>
    }

    // MARK: Query

    struct EventEntityQuery: EntityQuery {
        func entities(for identifiers: [EventEntity.ID]) async throws -> [EventEntity] {
            <#code#>
        }
    }
}
```

Define a `@UnionValue` enumeration for the `location` property, as in the following example,
by typing the first few characters of `calendar_location` in Xcode and selecting it from the code-completion suggestions.

```swift
@UnionValue
enum EventLocation {
    case place(GeoToolbox.PlaceDescriptor)
    case address(String)
}
```

Define a `@UnionValue` enumeration for the `alarms` property, as in the following example,
by typing the first few characters of `calendar_eventAlarm` in Xcode and selecting it from the code-completion suggestions.

```swift
@UnionValue
enum EventAlarm {
    case duration(Duration)
    case date(Date)
}
```

> Tip: Keep the cases that your app supports and remove the rest.

The schema supports the following system experiences:

- Siri
- Shortcuts

For more information about the App Intents framework and the experiences it supports,
see <doc://com.apple.documentation/documentation/AppIntents/getting-started-with-the-app-intents-framework>.

---

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)