Mail

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:

Mail intent schemas	Example phrases
Createdraft	“Compose a mail.” or “Write an email to example@example.com about photos from team dinner.”
Updatedraft	“Add example@example.com to recipients.” or “Set subject to coffee session.”
Savedraft	“Draft this email for later.” or “Save it.”
Opendraft	“Open the draft email to John and James.”
Deletedraft	“Delete this draft.” or “Trash my most recent draft.”
Senddraft	“Send this email.” or “Send this email tomorrow at 9 PM.”
Openmessage	“Open the email about team offsite instructions.”
Replymail	“Reply to an email.” or “Reply to mail thread with my manager.”
Forwardmail	“Forward an email.” or “Forward the email about the baseball schedule to John Appleseed.”
Updatemail	“Mark this email as read.” or “Flag this email.”
Archivemail	“Archive book club emails.” or “Archive emails from Nancy.”
Deletemail	“Delete emails from Julian.” or “Trash all mail messages from Example Store.”

For more information about making your app’s actions available to Apple Intelligence and Siri, see Apple Intelligence and Siri AI.

Mail domain use-case groups

A use-case group is a set of related schemas that share a single purpose. Xcode reports a build warning for each missing schema in a group your app partially supports.

The Mail domain has three use-case groups: composing, forwarding, and replying. The following table lists the use-case groups for each Mail schema:

Mail schema	Type	Use-case groups
Createdraft	Intent	composing
Draft	Entity	composing, forwarding, replying
Updatedraft	Intent	composing, forwarding, replying
Savedraft	Intent	composing, forwarding, replying
Senddraft	Intent	composing, forwarding, replying
Message	Entity	forwarding, replying
Forwardmail	Intent	forwarding
Replymail	Intent	replying

Mail

Overview

Mail domain use-case groups

Topics

Actions

Content and parameter types

See Also

Primary domains