Provide alternative names for your app that are more familiar or easier for users to speak.
When engaging your app’s services through Siri, users must include the name of your app in any spoken requests. To simplify those requests, you can provide Siri with a list of synonyms for your app name.
To define synonyms for your app name, include the
INAlternative key in the
Info file of your iOS app or WatchKit extension. (watchOS apps don’t inherit the synonyms of their iOS app, so you must declare them explicitly in both places). Place this key at the top level of your property list, configure it as an array of dictionaries, and add the following additional keys to each dictionary:
(Required) A string containing the alternative name by which users may refer to your app. Alternatively, specify a variable name that’s present in your app’s localized
App Name Pronunciation Hint
(Optional) A string containing a pronunciation hint for the alternate name, formatted in a "sounds like" format. Alternatively, specify a variable name that’s present in your app’s localized
To localize your app name and pronunciation hints, specify variable names (instead of actual values) for the
INAlternative keys of each entry. In your app’s
Info files, include the variable names as localization keys and set their values to appropriately localized strings. For example, you might set the value of the
INAlternative key to
APP and include an entry in your
Info file such as the following:
If you use a variable name for a key, you must provide an entry in your app’s base localization at a minimum. If the system can’t find a specific value for the key in the current localization, it uses the base localization as a fallback.
You may specify no more than three dictionaries in the array associated with the
INAlternative key. This limit is per localization, so each localized version of your
Info file may have its own set of alternatives.