Using Dictation

In addition to supporting standard Siri dictation using the microphone icon on the iOS keyboard, Drafts has a custom dictation interface which enables additional features, including:

  • Easier access: Dictation can be triggered in more different ways (details below).
  • Language and locale selection: Dictation can be used with any language supported by Siri dictation and languages/locales changed on-the-fly - even within a single dictation session.
  • Extended dictation time: Dictate longer segments of text, subject to some system limitation.

Apple Watch Note: This article is focused on dictation on iOS. See Drafts Apple Watch article for details on using dictation on the Apple Watch.

Accessing Dictation

As always, if dictation is enabled and supported on the iOS device running Drafts, dictation can be used with the keyboard microphone button as you would in any app. In addition, Drafts custom dictation interface can be opened via a number of methods:

  • Tap and hold new draft (“+”) button: This opens the new draft options selector. Select “Dictate” to start a new draft via dictation.
  • “Dictate” option in text selection menu: Place your cursor in the editor, and hold as if making a text selection. The “Dictate” option will open Drafts custom dictation interface and insert the results at the cursor location.
  • Use the Widget/3D Touch: The Drafts Today widget has a microphone button which launches the app directly to dictation of a new draft.
  • Custom Actions and Keyboard Keys: Dictation can also be opened and used via action, scripts and URL schemes. Actions to dictate new drafts, or insert text ship in the default “Keyboard-Basic” action group - but can also be installed from the directory:

Using Dictation

The first time the dictation interface is opened, Drafts will request permission to use your microphone and speech recognition services. Both of these permissions are required to support dictation, and will only be used for dictation sessions.

Once open, the dictation interface will immediately start listening. Just speak and a preview of the dictation results will be displayed at you speak. Once complete, tap the “Create” (or “Insert”) button to accept the results.

Dictation may be paused and resumed, and the text edited for minor corrections directly in the dictation interface.

The current selected locale/language is displayed above the pause button. Tap to select a different language. The dictation interface will remember the last used language the next time it is launched.

About Longer Dictation Sessions

Dictation is best suited to the capture of shorter snippets of text, but also supports dictating longer text. e aware that until a dictation session is completed by tapping the “Create” or “Insert” buttons, the session is temporary and the dictated text will not be saved.

There are iOS system limits on the length of an individual dictation session (around a minute). In longer dictations, Drafts will occasionally have to start a new listening session. When this happens Drafts gives a subtle visual and audio cue to indicate the new session beginning and inserts a “===” break line. Depending on network conditions, speed of dictation return results, etc., a second or two of dictation may be lost at these break point which will need review in the resulting text.

Using Dictation as a Service

The dictation interface in Drafts can also be accessed via URL scheme, with full x-callback-url support - or be triggered via script using methods on the editor script object. This allows dictation to be incorporated into automation flows, or just be customized to launch in a particular language, etc. This is an advanced topic and if you have questions about how to incorporate dictation in automation, please ask on the community forums.

Troubleshooting Dictation

The availability of dictation is subject to the same limitations as standard system Siri dictation and may not be available at all times. Newer devices support offline dictation in some languages, but not all. Often a network is required to dictate. If you receive consistent errors accessing dictation, please confirm that you have granted Drafts access permissions to both Speech and to use the Microphone in iOS Settings > Privacy.