<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INSpeakableString",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INSpeakableString"
  },
  "title" : "INSpeakableString"
}
-->

# INSpeakableString

A custom phrase to be resolved by an Intents extension.

```
class INSpeakableString
```

## Overview

When creating your Intents extension, you can define custom vocabulary for some types of intents. For example, a workout app may provide a custom `AppIntentVocabulary.plist` file with the names of standard workouts that are shared by all users of the app. In places where those terms might be used, the intent object contains an [`INSpeakableString`](/documentation/Intents/INSpeakableString) object.

Use the contents of an [`INSpeakableString`](/documentation/Intents/INSpeakableString) object to resolve the specified term during the handling of an intent. If the user spoke a term that is defined in your `AppIntentVocabulary.plist` file, Siri includes the identifier of that term in the string’s [`identifier`](/documentation/Intents/INSpeakable/identifier) property. For unrecognized terms, the identifier is `nil`.

## Topics

### Initializing a Speakable String

[`init(spokenPhrase:)`](/documentation/Intents/INSpeakableString/init(spokenPhrase:))

Initializes the string with the specified phrase.

[`init(vocabularyIdentifier:spokenPhrase:pronunciationHint:)`](/documentation/Intents/INSpeakableString/init(vocabularyIdentifier:spokenPhrase:pronunciationHint:))

Initializes the string with a phrase from your app’s vocabulary.

[`init(identifier:spokenPhrase:pronunciationHint:)`](/documentation/Intents/INSpeakableString/init(identifier:spokenPhrase:pronunciationHint:))

Initializes the string with the specified identifier and phrase information.


---

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)