Drafts updates often. Keep up with the latest additions and fixes below. You can also always get highlights of the latest additions in the app via “What’s New” (Settings on iOS, Help menu on Mac).
Drafts is ready for iOS 15 and macOS 12! Updated for compatibility, of course, but also to take advantage of some of the great new features. New details below, but Drafts works great with “Live Text” to capture text from images, has full support for Shortcuts on the Mac, and brings great new iPad features, like powerful external keyboard menus.
We have re-written the Drafts Apple Watch app from the ground up to use the latest watchOS technologies. It’s still the best, easiest way to capture ideas on the go, but has a few new tricks:
- Multiple complication types to capture, capture with options, or see your inbox or flagged draft count.
- Inbox drafts synced to watch now reflect your default workspace options on the phone.
- Flagged drafts now also synced to the watch.
- Requires watchOS 7.1 or greater.
Note that you may need to reconfigure your complication options after upgrade, especially if you want auto-capture, which was previously a setting and not based on the complication used.
We’re ready for Shortcuts on the Mac! It’s just not quite ready for us. Look for full, cross-platform support for all of Drafts’ Shortcuts actions when macOS 12 (Monterey) is released in the coming weeks!
In the meantime, enjoy these new shortcut actions on iOS:
- Get Current Draft: Retrieves the draft object for the draft currently open in the editor.
- Open Draft Enhancements: The “Open Draft” shortcut action now has a bunch of additional optional parameters to configure Drafts while opening - to load a workspace, actions groups, hide/show the drafts and action lists, etc. Great for bookmarking a specific set of options in a Shortcut.
Up to now, Drafts file actions and scripts have been limited to working with files in the “Drafts” folder in iCloud Drive (or by working directly with cloud-provider APIs, like Dropbox and Google Drive). With folder bookmarks, it is now possible to grant permissions to additional folders outside the Drafts App Sandbox, making it easier to integrate with other apps and services, to, say, export a draft content to another system - like an Obsidian Vault, etc.
Drafts has been tested and works great with the new “Live Text” features in iOS 15 and macOS 12. In addition, we have incorporated document scanning to OCR directly in the iOS app. Tap and hold the “+” and select “Scan Document” to open the document scanning camera. It supports scanning multi-page documents, and directly runs the results through OCR to create a new draft with the result text.
Drafts capture flow used in the iOS Share extension and the “Capture” window on Mac, has received a number of updates:
- Both now remember your recently used selections for appending and prepending to existing drafts, to make it easier to re-use active drafts.
- The Mac Share extension now displays in a new capture window, allow preview/editing of captured text as well as appending-prepending to other drafts - more like the iOS Share extension.
- Mac Services menu now contains “Capture to Drafts” and “Capture to Drafts with Options” services to send text selections to Drafts from anywhere in the system. The “with Options” version displays a capture window, while the other version capture silently as a new draft.
/captureURL scheme, and Shortcut “Show Capture” action, allow you display the capture window in app, optionally pre-filled with text and tags. This is useful in capture workflows from other apps, as well as web bookmarklets.
- New tag suggestion interface on iOS to make it easier to tag your drafts with just the right tags.
- On iOS, long press on links to other drafts now generates a preview and several command options for the draft. This includes
drafts://openlinks in link mode.
- On Mac,
command-clickon links to other drafts to open them in a new window.
- Tags in the tag filter pane now have contextual menu (tap and hold) with “rename” and “delete” commands to bulk manage tags. These options already existed in the draft list “Operations” commands, but these versions pre-fill the tag value for better accuracy.
- New “What’s New” screen accessible via Settings > What’s New (iOS) or Help > What’s New (macOS)
- “Run Shortcut” action step has new “Return to Drafts” option. If disabled, Drafts will not include callback parameters to return to Drafts after completing the Shortcut. If you do not care about a result from Shortcuts, and wish to end up in a different app when the shortcut finishes, disable this option.
[[hashtags]]template tag. Returns assigned tags as comma-separated list, with each tag prefixed with a “#”. Convenience tag to remove the need to script this conversion when exporting to systems that use hash tags.
- Estimated read time now calculated and displayed in draft detail
- Fix: Markdown syntaxes not recognizing [ref][links] with space.
- Fix: After success “Trash” would not load next draft properly in focus mode.
- Refactor the next-previous button logic because it was not updating properly in some cases.
- A few new app icon options.
- Require iOS 14.1 or greater.
- Remove pre-iOS 14 “Today” widgets.
- More toolbar options to customize your toolbar. Focus, link modes, preview, arrange buttons now available.
version.delete()function to allow scripted deletion of versions in the version history. (docs)
ActionLogscript object used to read and manipulation entries in the Action Log. Generally accessed from the
/scandocumentURL scheme. (docs)
editor.scanDocument() -> stringfunction. Also similar to
editor.dictate()function, opens the document scanner and returns any OCR results as a string which you can do with as you please. (docs)
- New “Get Current Draft” shortcut action retreives the draft currently open in the main editor.
- “Open Draft” shortcut action has additional options to configure state of window (show/hide side panes, load workspace, etc. - docs)
/createURL schemes now support several additional parameters to configure the environment (docs):
loadActionBarGroup: take names of valid group/workspaces and applies them
It is now possible to select custom light and dark themes for Home Screen (iOS) and Notification Center (macOS) widgets from the built-in and custom themes you have installed in Drafts. To make changes, tap and hold on a widget, select “Edit Widget”, and make changes in the widget configuration.
We have also added dozens of new icons for actions/workspaces in categories like Health, Animals, Education, Email, and more.
If you create custom themes, you may wish to add the following new keys in
widgetForegroundAlternate. If not present, these values will fall back to existing related keys:
foreground, so existing themes should work out of the box without updates.
Extensive integration with two of the most popular task managers: Google Tasks and Microsoft To Do. This version adds new action steps which can create individual tasks, or add each line of draft as a task, to lists in either Google Tasks or Microsoft To Do.
Both services are available via scripting, with powerful script objects with convenience methods for creating and updated tasks and lists, while also exposing the full APIs to advanced users.
For sample actions and details:
Arrange mode has better external keyboard support, especially on iOS, including: -
⌘-return to cancel or accept changes - Arrow keys navigate up-down in the list -
⌘-up/down move the selected line up and down in the list.
- Change (iOS): iOS 12 no longer supported.
- Fix (iOS): URL scheme could be called twice on cold start of app.
- Fix: Better support for import of exported files from Drafts 3 or earlier
- Script changes:
attendeesarray to access (readonly) attendee list.
availabilitystring with values
- Fix: Drafts set in the editor via
editor.loadshould get added to recent drafts list.
- Fix (iOS): Messages app background in dark mode had issues.
- Fix (macOS):
loadActionBarURLs were not supported on Mac.
- Fix (macOS): Possible fix case where “Undo” would stop working in the editor until the app was restarted.
- Refactor assets to save on binary size.
Starting with version 27, the iOS and Mac changelogs were merged on this page. For previous release notes, see archives below.