---
title: Specifying Synonyms for Your App Name
framework: sirikit
role: article
role_heading: Article
path: sirikit/specifying-synonyms-for-your-app-name
---

# Specifying Synonyms for Your App Name

Provide alternative names for your app that are more familiar or easier for users to speak.

## Overview

Overview 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. important: Siri recognizes alternative app names only for apps that include an Intents app extension with support for one or more intents. Alternative names must be either based on your app’s original name or be a legitimate name common to users of the app. You may not include the names of other apps on the system in an attempt to divert requests to your app. To define synonyms for your app name, include the INAlternativeAppNames key in the Info.plist 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: important: If you specify synonyms for your watchOS app, you must build your app for deployment on watchOS 4 or later. An app that includes synonyms won’t install on earlier versions of watchOS. In addition, the synonyms you specify must be identical to the ones that you specified for your iOS app. To localize your app name and pronunciation hints, specify variable names (instead of actual values) for the INAlternativeAppName and INAlternativeAppNamePronunciationHint keys of each entry. In your app’s InfoPlist.strings 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 INAlternativeAppName key to APP_NAME_SYNONYM_1 and include an entry in your InfoPlist.strings file such as the following: APP_NAME_SYNONYM_1 = "Localized Name 1" 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 INAlternativeAppNames key. This limit is per localization, so each localized version of your Info.plist file may have its own set of alternatives.

## See Also

### Articles

- [Adding User Interactivity with Siri Shortcuts and the Shortcuts App](sirikit/adding-user-interactivity-with-siri-shortcuts-and-the-shortcuts-app.md)
- [Defining Relevant Shortcuts for the Siri Watch Face](sirikit/defining-relevant-shortcuts-for-the-siri-watch-face.md)
- [Deleting Donated Shortcuts](sirikit/deleting-donated-shortcuts.md)
- [Dispatching intents to handlers](sirikit/dispatching-intents-to-handlers.md)
- [Improving Siri Media Interactions and App Selection](sirikit/improving-siri-media-interactions-and-app-selection.md)
- [Improving interactions between Siri and your messaging app](sirikit/improving-interactions-between-siri-and-your-messaging-app.md)
- [Registering Custom Vocabulary with SiriKit](sirikit/registering-custom-vocabulary-with-sirikit.md)
- [Confirming the Details of an Intent](sirikit/confirming-the-details-of-an-intent.md)
- [Handling an Intent](sirikit/handling-an-intent.md)
- [Resolving the Parameters of an Intent](sirikit/resolving-the-parameters-of-an-intent.md)
- [Generating a List of Ride Options](sirikit/generating-a-list-of-ride-options.md)
- [Handling the Ride-Booking Intents](sirikit/handling-the-ride-booking-intents.md)
- [Donating Reservations](sirikit/donating-reservations.md)
- [Intent Phrases](sirikit/intent-phrases.md)
- [Localizing Your Vocabulary for Chinese Dialects](sirikit/localizing-your-vocabulary-for-chinese-dialects.md)