Make your email app’s actions available to Apple Intelligence and Siri by adopting schemas for common email actions.
Overview
The .mail domain defines app schemas that provide a structured representation for common email actions and content. Apply schemas in the .mail domain to make your app’s email functionality available to Apple Intelligence and Siri. Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across email apps. For example, a person can compose an email on different apps that support the createDraft 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.
Mail intent schemas | Example phrases |
|---|---|
“Compose a mail.” or “Write an email to example@example.com about photos from team dinner.” | |
“Add example@example.com to recipients.” or “Set subject to coffee session.” | |
“Draft this email for later.” or “Save it.” | |
“Open the draft email to John and James.” | |
“Delete this draft.” or “Trash my most recent draft.” | |
“Send this email.” or “Send this email tomorrow at 9 PM.” | |
“Open the email about team offsite instructions.” | |
“Reply to an email.” or “Reply to mail thread with my manager.” | |
“Forward an email.” or “Forward the email about the baseball schedule to John Appleseed.” | |
“Mark this email as read.” or “Flag this email.” | |
“Archive book club emails.” or “Archive emails from Nancy.” | |
“Delete emails from Julian.” or “Trash all mail messages from Example Store.” |
At build time, Xcode validates whether your app implements all the schemas in the group.
For more information about making your app’s actions available to Apple Intelligence and Siri, see Apple Intelligence and Siri AI.
Topics
Actions
archiveMailcreateDraftdeleteDraftdeleteMailforwardMailopenDraftopenMessagereplyMailsaveDraftsendDraftupdateDraftupdateMailAppSchema.MailIntent