Siri

Your app can integrate with Siri to let the user perform certain tasks in response to spoken commands and questions. Siri handles all of the language processing and semantic analysis needed to turn these spoken requests into instructions your app can handle. Your app defines the tasks it supports, validates information received, provides information for Siri to present, and takes action. Information from your app’s response is spoken by Siri and appears in the Siri interface. If appropriate, your app can provide a custom user interface for Siri to display. A fitness app, for example, might provide custom workout information.

Strive for a voice-driven experience that doesn’t require touching or looking at the screen. People often interact with Siri through a headset, through their car, or from across the room. To the extent possible, let users complete tasks without unlocking their phone.

Don’t attempt to mimic or manipulate Siri. Your app should never impersonate Siri, attempt to reproduce the functionality Siri provides, or provide a response that appears to come from Apple.

Be appropriate. Never include content that could be offensive or demeaning.

Don’t advertise. Your app’s Siri experience should never include advertisements, marketing, or in-app purchase sales pitches.

Supported Interactions

iOS apps that offer the following services can integrate with Siri.

Service Supported Siri interactions
Audio and video calling Initiate calls.
Search the call history.
CarPlay integration Activate and save a driver's settings.
Change the car’s audio source.
Change the car’s climate.
Change the car’s defroster settings.
Change the car’s seat settings.
Change the car’s radio station.
Fitness activities Start, pause, resume, end, and cancel workouts.
Lists and notes Create to-do lists and items.
Search for to-do lists and items.
Mark to-do list items as complete.
Create reminders based on a date, time, and/or location.
Create notes.
Search for notes.
Modify notes.
Messaging Send messages.
Read received messages.
Search for messages.
Payments Send payments.
Request payments.
Pay bills.
Search for bills.
Search for and view account information, including balances, points, and miles.
Transfer money between accounts.
Photo management Search for photos and show them in the app.
Ride booking Book rides.
Provide ride status information.
Vehicle integration Activate hazard lights or honk the horn.
Lock and unlock the doors.
Check the current fuel or power level.
Visual codes Show a visual code, like a QR code or bar code.

Responding to People

Respond quickly and minimize interaction. People use Siri for convenience and expect a fast response. Present efficient, focused choices that reduce the possibility of additional prompting.

Take people directly to content. Transitions from Siri to your app should go directly to the expected destination. Don’t show intermediary screens or messages that slow down the experience.

Be relevant and accurate. Make your app’s response relevant to the user’s current request and expectations. For example, if the user asks Siri to send a message with your app, send a message. Don't perform a different action.

When a request has a financial impact, default to the safest and least expensive option. Never deceive the user or misrepresent information. For a purchase with multiple pricing levels, don’t default to the most expensive. At the point where a user is making a payment, don’t charge extra fees without informing them.

Designing a Custom Interface

Make sure your interface integrates well with Siri. It’s fine to use your app’s colors, imagery, and other design elements to communicate your brand, but any interface elements should still feel like they belong in Siri. Unless your app requires a fully custom interface, integrate your content into the default interface Siri provides.

Provide ample margins and padding. Avoid extending content to the edges of your interface unless it's content that appears to flow naturally offscreen, like a map. In general, provide a margin of at least a few pixels between each edge of your interface and the content. Use the app icon at the top of your interface for alignment guidance. Content tends to work well when lined up with the center of this icon.

Minimize the height of your interface. Ideally, your interface should be no taller than the height of the screen, so the user can see all your content without scrolling.

Don't create an interface that appears interactive. Your interface can't respond to gestures—other than a tap, which opens your app—or other events when displayed within Siri, so avoid displaying imagery or shapes that appear interactive.

Don’t include your app name or icon in your interface. The system automatically shows this information.

Increasing Accuracy

If appropriate, define custom vocabulary. Help Siri learn more about the actions your app performs by defining specific terms people might actually use in requests, like account names, contact names, photo tags, photo album names, ride options, and workout names. These terms should be nongeneric and unique to your app. Never include other app names, terms that are obviously connected with other apps, inappropriate language, or reserved phrases, such as “Hey Siri.” Note that any terms you define are used by Siri to help resolve requests, but aren’t guaranteed to be recognized.

Consider defining alternate app names. If people vary the pronunciation of your app's name, you can provide a list of alternative names to increase flexibility when targeting your app with Siri. For example, a UnicornChat app might define the term Unicorn as an alternate app name. Never list other app names as alternate names for your app.

Provide example requests. Provide Siri with example phrases to show in the guide that appears when you tap the Help button in the Siri interface. Use these phrases to teach people the easiest and most efficient way to use Siri with your app. For developer guidance, see Intent Phrases.

Learn More

For related design guidance, see watchOS > Siri. For developer guidance, see SiriKit.