<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Speech",
  "identifier" : "/documentation/Speech/DictationTranscriber/Preset",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Speech"
    ],
    "preciseIdentifier" : "s:6Speech20DictationTranscriberC6PresetV"
  },
  "title" : "DictationTranscriber.Preset"
}
-->

# DictationTranscriber.Preset

Predefined transcriber configurations.

```
struct Preset
```

## Overview

You can configure a transcriber with a preset, or modify the values of a preset’s properties and configure a transcriber with the modified values. You can also create your own presets by extending this type.

It is not necessary to use a preset at all; you can also use the transcriber’s designated initializer to completely customize its configuration.

This example configures a transcriber according to the `shortDictation` preset, but adds emoji recognition:

```swift
let preset = DictationTranscriber.Preset.shortDictation
let transcriber = DictationTranscriber(
    locale: Locale.current,
    contentHints: preset.contentHints,
    transcriptionOptions: preset.transcriptionOptions.union([.emoji])
    reportingOptions: preset.reportingOptions
    attributeOptions: preset.attributeOptions
)
```

This table lists the presets and their configurations:

|Preset                     |[shortForm](doc://com.apple.speech/documentation/Speech/DictationTranscriber/ContentHint/shortForm)|[volatileResults](doc://com.apple.speech/documentation/Speech/DictationTranscriber/ReportingOption/volatileResults)|[frequentFinalization](doc://com.apple.speech/documentation/Speech/DictationTranscriber/ReportingOption/frequentFinalization)|[audioTimeRange](doc://com.apple.speech/documentation/Speech/DictationTranscriber/ResultAttributeOption/audioTimeRange)|[punctuation](doc://com.apple.speech/documentation/Speech/DictationTranscriber/TranscriptionOption/punctuation)|
|---------------------------|---------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|
|`phrase`                   |**Yes**                                                                                            |No                                                                                                                 |No                                                                                                                           |No                                                                                                                     |No                                                                                                             |
|`shortDictation`           |**Yes**                                                                                            |No                                                                                                                 |No                                                                                                                           |No                                                                                                                     |**Yes**                                                                                                        |
|`progressiveShortDictation`|**Yes**                                                                                            |**Yes**                                                                                                            |**Yes**                                                                                                                      |No                                                                                                                     |**Yes**                                                                                                        |
|`longDictation`            |No                                                                                                 |No                                                                                                                 |No                                                                                                                           |No                                                                                                                     |**Yes**                                                                                                        |
|`progressiveLongDictation` |No                                                                                                 |**Yes**                                                                                                            |No                                                                                                                           |No                                                                                                                     |**Yes**                                                                                                        |
|`timeIndexedLongDictation` |No                                                                                                 |No                                                                                                                 |No                                                                                                                           |**Yes**                                                                                                                |**Yes**                                                                                                        |

## Topics

### Standard presets

[`static let phrase: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/phrase)

Configuration for a short phrase without punctuation.

[`static let shortDictation: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/shortDictation)

Configuration for about a minute of audio.

[`static let progressiveShortDictation: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/progressiveShortDictation)

Configuration for immediate transcription of about a minute of live audio.

[`static let longDictation: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/longDictation)

Configuration for more than a minute of audio.

[`static let progressiveLongDictation: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/progressiveLongDictation)

Configuration for immediate transcription of lengthy audio.

[`static let timeIndexedLongDictation: DictationTranscriber.Preset`](/documentation/Speech/DictationTranscriber/Preset/timeIndexedLongDictation)

Configure for lengthy audio, cross-referencing words to time-codes.

### Creating a preset

[`init(contentHints: Set<DictationTranscriber.ContentHint>, transcriptionOptions: Set<DictationTranscriber.TranscriptionOption>, reportingOptions: Set<DictationTranscriber.ReportingOption>, attributeOptions: Set<DictationTranscriber.ResultAttributeOption>)`](/documentation/Speech/DictationTranscriber/Preset/init(contentHints:transcriptionOptions:reportingOptions:attributeOptions:))

Creates a preset.

### Getting preset properties

[`var attributeOptions: Set<DictationTranscriber.ResultAttributeOption>`](/documentation/Speech/DictationTranscriber/Preset/attributeOptions)

Options relating to the attributes of the transcription appropriate for this preset.

[`var contentHints: Set<DictationTranscriber.ContentHint>`](/documentation/Speech/DictationTranscriber/Preset/contentHints)

Expected characteristics of the spoken audio appropriate for this preset.

[`var reportingOptions: Set<DictationTranscriber.ReportingOption>`](/documentation/Speech/DictationTranscriber/Preset/reportingOptions)

Options relating to the transcriber’s result delivery appropriate for this preset.

[`var transcriptionOptions: Set<DictationTranscriber.TranscriptionOption>`](/documentation/Speech/DictationTranscriber/Preset/transcriptionOptions)

Options relating to the text of the transcription appropriate for this preset.

## Relationships

### Conforms To

[`Hashable`](/documentation/Swift/Hashable)

[`Sendable`](/documentation/Swift/Sendable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Equatable`](/documentation/Swift/Equatable)

---

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)