<!--
{
  "documentType" : "article",
  "framework" : "AppIntents",
  "identifier" : "/documentation/AppIntents/app-schema-domain-clock",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Clock"
}
-->

# Clock

Make your clock app’s actions available to Apple Intelligence and Siri by adopting schemas for common alarm and timer actions.

## Discussion

The `.clock` domain defines app schemas that provide a
structured representation for common alarm and timer actions and content.
Apply schemas in the `.clock` domain to make your app’s clock functionality available to Apple Intelligence and Siri.
Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across clock apps.
For example, a person can set an alarm on different apps that support the
[`createAlarm`](/documentation/AppIntents/AppSchema/ClockIntent/createAlarm) schema with the same phrases.

The following table maps example phrases that apply to each schema.
Your app needs to support all of these schemas when it supports any one of them.

|Clock intent schemas                                                                      |Example phrases                                                   |
|------------------------------------------------------------------------------------------|------------------------------------------------------------------|
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/createAlarm`` |“Set an alarm.” or “Wake me up at 7 AM.”                          |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/updateAlarm`` |“Change my alarm.” or “Change the 7 AM alarm to 8 AM.”            |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/snoozeAlarm`` |“Snooze.” or “Give me 5 more minutes.”                            |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/dismissAlarm``|“Dismiss the alarm.” or “Stop the alarm.”                         |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/deleteAlarm`` |“Delete my alarm.” or “Remove the 7 AM alarm.”                    |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/createTimer`` |“Set a timer.” or “Timer for 5 minutes.”                          |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/updateTimer`` |“Add 5 minutes to the timer.” or “Change the timer to 10 minutes.”|
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/pauseTimer``  |“Pause the timer.”                                                |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/resumeTimer`` |“Resume the timer.” or “Start the timer again.”                   |
|``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/ClockIntent/cancelTimer`` |“Cancel the timer.” or “Stop the timer.”                          |

At build time, Xcode validates whether your app implements all the schemas in the group.

> Tip: Xcode generates a template implementation when you type `clock_` and select a schema from the suggestions list.

For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai).

## Topics

### Actions

[`var cancelTimer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/cancelTimer)

An intent schema that cancels timers.

[`var createAlarm: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/createAlarm)

An intent schema that creates an alarm.

[`var createTimer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/createTimer)

An intent schema that creates a timer.

[`var deleteAlarm: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/deleteAlarm)

An intent schema that deletes the alarms.

[`var dismissAlarm: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/dismissAlarm)

An intent schema that dismisses a firing or snoozed alarm.

[`var pauseTimer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/pauseTimer)

An intent schema that pauses a timer.

[`var resumeTimer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/resumeTimer)

An intent schema that resumes a timer.

[`var snoozeAlarm: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/snoozeAlarm)

An intent schema that snoozes the firing alarm.

[`var updateAlarm: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/updateAlarm)

An intent schema that updates the alarm, for example, turn on / off the alarm, change the label, time, or repeating schedule.

[`var updateTimer: some AppSchemaIntent`](/documentation/AppIntents/AppSchema/ClockIntent/updateTimer)

An intent schema that updates the timer’s attributes.

[`protocol ClockIntent`](/documentation/AppIntents/AppSchema/ClockIntent)

Identifies intent schemas in the clock domain.

### Content and parameter types

[`var alarm: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/ClockEntity/alarm)

An entity schema for an alarm.

[`var timer: some AppSchemaEntity`](/documentation/AppIntents/AppSchema/ClockEntity/timer)

An entity schema for a timer.

[`protocol ClockEntity`](/documentation/AppIntents/AppSchema/ClockEntity)

Identifies entity schemas in the clock domain.

### Types for static parameters

[`var alarmTriggerState: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/ClockEnum/alarmTriggerState)

An enum schema for an alarm trigger state parameter.

[`var timerState: some AppSchemaEnum`](/documentation/AppIntents/AppSchema/ClockEnum/timerState)

An enum schema for a timer state parameter.

[`protocol ClockEnum`](/documentation/AppIntents/AppSchema/ClockEnum)

Identifies enum schemas in the clock domain.



---

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)