<!--
{
  "documentType" : "article",
  "framework" : "SiriKit",
  "identifier" : "/documentation/SiriKit/global-vocabulary-reference",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Global Vocabulary Reference"
}
-->

# Global Vocabulary Reference

Understand the keys and values included in your app’s global vocabulary file.

## Discussion

The `AppIntentVocabulary.plist` file in your iOS app contains examples of how users can engage your app’s intents from Siri and any custom terminology that applies to all users of the app. Place the `AppIntentVocabulary.plist` file in the bundle of your iOS app. You can include localized versions of your vocabulary property list file in the language-specific project (.lproj) directories of your app. When you submit your app to the App Store, your `AppIntentVocabulary.plist` file and any localized versions of that file are sent to Siri for processing. The content of those files remains on the server and that content is specific to that app version.

The Root dictionary of the `AppIntentVocabulary.plist` file contains the following keys:

- `ParameterVocabularies`: (Optional) An array of dictionaries that define the custom terms that apply to all users of your app. For information about specifying custom terms, see <doc://com.apple.documentation/documentation/SiriKit/parameter-vocabularies>.
- `IntentPhrases`: (Optional, but recommended) An array of dictionaries containing the example phrases for users. Siri displays these phrases and they guide and help Siri understand how users engage your app’s intents. For information on providing example phrases, see <doc://com.apple.documentation/documentation/SiriKit/intent-phrases>.

> Important:
> During development, Xcode syncs your vocabulary with Siri, which uses the vocabulary to interpret requests from the version of your app on your development device. Ingestion of your vocabulary data isn’t instantaneous, though, so you may need to wait a minute or two before testing your Siri capabilities.

## Topics

### Property List Keys

  <doc://com.apple.sirikit/documentation/SiriKit/parameter-vocabularies>

  <doc://com.apple.sirikit/documentation/SiriKit/intent-phrases>

### Localization

  <doc://com.apple.sirikit/documentation/SiriKit/localizing-your-vocabulary-for-chinese-dialects>



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)