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).
/createURL scheme now supports optional
folder(inbox/archive) query arguments. (docs)
For those who are fond of using color to distinguish items on screen, there is now an option to use action tint colors in the Action Bar. To enable on iOS, scroll to Action Bar options in
Aa editor settings. On Mac, toggle menu item in Action Bar’s group selection drop-down menu.
It is sometimes useful to output a date that is relative to another date (usually the current one), adjusted by some time interval. It has always been possible in script to create and adjust future and past dates, but now it is easier with the addition of a new method to adjust dates using simple date math expressions.
This begins with a new way to create related date expressions, which consist of a list of plus or minus time intervals which can applied to a date. Each expression look like
(+|-)(integer) (unit), and can be combined in a list to make multiple adjustments to a date. A couple of quick examples:
+1 year: Add one year to the date.
-2 months -6 hours: Subtract two months and six hours from date.
Units supported are: year, month, day, hour, minute, second. Units can be used in either singular or plural forms.
[adjustDate(date, expression) function](https://scripting.getdrafts.com/globals#adjustdate), or by providing an additional expression argument, along with the strftime formatting argument, in template tags which work with date. Those tags are the
2022-06-23 tags. Again, by example:
[[date|+1 year|%Y-%m-%d]]: Current date next year. So, on May 1, 2022, this would output: 2023-05-01.
[[created|-1 month|%Y-%m-%d]]: Output a month before the creation date of the draft.
Adjustment expressions are calendar-aware, such that adding 1 month to May 31 would result in June 30, since June does not have a 31st.
A couple of ready to use examples:
Drafts templates, with their square-bracket,
# Drafts Release Notes-style tags are still the default throughout actions, but with this update we have introduced the option to use an alternate template engine based on Mustache templates.
Mustache templates provide some additional power, like the ability to have conditionally rendered blocks, loop over arrays, insert information from other drafts, as well as more powerful filtering options. For details, see the Mustache documentation.
Mustache templates are available as a option on all long-form templates in action steps, can can also be triggered via script using the
If you often capture using the share extension and Safari, you might be interested in switching your web capture template to use Mustache. This has the advantage of being able to use conditional sections to only render part of the text template for the captured text selection if a selection exists.
Drafts now includes basic syntax hightlighting definitions for both Drafts templates, and the new Mustache templates. When editing long-form templates in actions steps, the templates can now (optionally) be opened in an editor with syntax highlighting and basic autocomplete for common tags. Use the edit button by the template in the action editor to open the template editor.
*New (Mac):- Ability to select alternate dock icons in Editor Preferences. Not quite like changing the app icon on iOS, but the best you can do with native Mac APIs. Be aware the alternate dock icon:
*New:- A few new monochrome alternate icon options, with dark logo.
*Fix:- Update Dropbox authentication to avoid issue with credentials expiring shortly after creation, required re-authentication.
*Fix (Mac):- Issue with side panels overlapping editor text after being hidden-shown in some cases.
*Fix:- Drafts returned by
Draft.queryByTitle might not update properly if modified in a script while also being loaded in the editor.
New (iOS):: Commands under the draft icon long-press menu to go directly to version and action log histories.
*Change (Mac):- Side panels no longer animate when hiding and show.
*Fix:- Issue with draft scrolling to top when editing some lists with typewriter scrolling enabled.
*Fix:- Find window not remembering options.
*Fix:- Error importing older exported Workspaces.
*New (Mac):- Add “flag” toolbar button option.
*Change (Mac):- Allow “open in new window” windows to remember last used size.
*Change (Mac):- Update Markdown syntaxes to better match parser output for middle of the word bold and italics, which are only supported when using asterisks, not underscores.
*Change:- Update to
2022-02-22 version of Notion API and drop “(Beta)” label, since Notion announced the API is out of beta.
*Change:- Break up longer drafts into more paragraph blocks when posting to Notion, to avoid block size limits.
*Change:- Adjustments to tag filtering pane.
*Fix:- VoiceOver text for word/character counts should respect settings to hide/show those counts.
*Fix:- VoiceOver should include tags in draft list.
Lots of general usability and interface and improvements, including updated icons, some button re-organization, and a variety of new features. Highlights:
(v)down-arrow menus at the top of the list. If you would also like to access from the bottom of the screen, enable workspace/action group bars in
(i)detail button was removed to reduce clutter. Long press the draft icon at the top left of the editor and select “Get Info” to access draft details.
Aaeditor settings) to toggle visibility of the word, character, and selection counts. These can also be toggled quickly by long-pressing the
Aaeditor settings view. These options can quickly be toggled using the long-press menu on the
This version introduces basic integration with the Notion online project management system. Notion’s API is still in beta but has become stable enough to start offering integration in Drafts. Be aware that aspects of this functionality may change or stop working if Notion makes changes in its API during the development process. We also plan to expand functionality based on feedback, so if you are using Drafts with Notion, please let us know other features you would like to see added.
This initial integration provides:
[Notionscript object](https://scripting.getdrafts.com/classes/notion), which provides access to the entire Notion API for advanced use cases.
For details, example actions, etc., see our Notion Integration Guide.
New “Maintenance” view in Settings/Preferences. This view is a home for completely optional periodic maintenance tasks to help restore defaults, clean up data you may no longer care about, or improve performance. Make sure you understand what the tasks do before running one because some are destructive and not reversible. Details on available tasks in the User Guide.
editorscript object in actions, and via autocomplete, auto-match, and list completions, to better participate in the editor’s undo/redo stack and avoid a few cases where undo could stop functioning.
Reminderscript object now has
editor.focusModeEnableddeprecated, and replaced by
editor.pinningEnabled(still works, may be phased out on future release)
ActionLog.statusreadonly property to indicate status (“completed”, “failed”, etc.) of the log entry.
Operations to rename and delete tags should look also look for drafts with those tags in the trash.
Better handle import of text files with some uncommon text encodings.
Crasher using share extension for some users.
Misc. small fixes.
Updates to default actions groups for new installs. Note that the default groups can be re-installed from the Directory, if desired.
Drafts now registers itself to open most common audio and video formats. If you open an audio or video file in Drafts, you will be prompted with an option to transcribe text using speech recognition. Speech recognition will process the audio in the same way as dictation, so dictation commands for punctuation, etc., are supported.
This is most useful for transcribing the content of single-speaker voice audio, like a voice memo, or recorded lecture, but it will happily attempt to transcribe other forms of audio as well, though the quality of the results may vary.
To try it out:
File > Import...from the main menu, and choose and audio or video file.
If you plan to use this transcription, please read the full documentation to understand its capabilities and limitations.
If you attempt to open a PDF file in Drafts, you will now be offered the option to extract text from the PDF into a new Drafts.
To try it out:
File > Import...from the main menu, and choose a PDF file.
Extraction will only grab actual text content from the PDF. Some PDF files have embedded image content and will not work with this feature.
Learn more about PDF Text Extraction
*Change:- Replaced microphone icon on Apple Watch complications and buttons. Since Apple has made it so it is not possible to launch input directly to dictation on watchOS 8.1, it no longer makes sense to use microphone icon. (PS: Please let Apple know if you do not like this change! We’d love to get back the ability to go straight to dictation.)
*Change:- Change sort order of trash to use accessed date/descending to make it easier to find and restore items recently added to the trash.
[[line]] template tag when used with specifying a line argument, now returns the text of the current selection extended to the beginning and end of the lines. Useful for grabbing the current line text in an action without needing to select the text first.
*Fix (iOS):- Issues sorting actions upwards in the action list.
*Fix:- Issue appending to files in Bookmark folders from different devices.
A variety of performance improvements and fixed for visual glitches.
Bug fix release for a few issues in the inital 29.0 release.
*Fix:- Widgets not functioning properly on Big Sur.
Drafts provides a wide variety of actions for use in Apple’s automation app, Shortcuts. These can be used for simple things like creating a new draft, opening Drafts directly to specific workspaces – or advanced processing by querying and updating multiple drafts.
With macOS 12, Apple has brought the power of Shortcuts to the Mac, and Drafts is ready. All Drafts’ Shortcuts actions now work on both iOS and Mac, and shortcuts created using these actions work cross-platform, allowing you to create, modify, and use those shortcuts on all your devices!
Drafts now includes an extensible system to provide drop-down autocomplete suggestions while typing in the editor. Autocomplete includes a global system for creating and inserting text snippets. Additional autocomplete suggestions can also be provided by syntax definitions.
Do you have snippets of text you reuse regularly? Email addresses? Templates? Then autocomplete suggestions will be a handy addition.
Autocomplete tab in Editor Preferences (
Aa button below editor) to get started configuring your suggestion drop-down items. Set the “Trigger” text to control what sequence of characters will trigger the suggestion drop-down to appear, and add items for frequently used snippets. Suggestions can use Drafts template tags to insert the current date, location, or other values.
Drafts built-in Markdown syntaxes (Markdown, GitHub Markdown, and MultiMarkdown) now include two additional autocompletion features to work with other drafts in your library:
[[to trigger auto-completion of
[[wiki-style]]links to other drafts by title.
<<to trigger the selection of another draft and insert the full content of that draft.
These features are implemented using a new set of configuration options available to all syntax definitions. If you create custom syntax definitions, and would like to add this functionality (or similar) to your custom syntax definitions, take a look at the related documentation on autocomplete in syntaxes
_Learn more about Autocomplete_
titleparam would not properly find drafts with “:” in the title parameter.
*Fix:- “Last Draft” option available with long press on app icon would not work properly on iOS 15 if the app was already running and the new draft timeout had passed.
Configuration tweak to allow the “Add Link” option to work to create links to the current draft in Quick Notes.
Bug fix release addressing a few issues in release 28:
#drafts, #meta, #documentation, #event, #itemplate tag should replace spaces in tags with “-“.
Eventobject should be a read/write property, not read only.
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:
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.
Learn More About Drafts on Apple Watch →
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:
Learn More About Shortcuts →
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.
Learn More About Bookmarks →
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.
Learn More About Live Text & Scanning →
Drafts capture flow used in the iOS Share extension and the “Capture” window on Mac, has received a number of updates:
/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.
Learn more about the iOS Share Extension and Mac Capture Window
drafts://openlinks in link mode.
command-clickon links to other drafts to open them in a new window.
#drafts, #meta, #documentation, #event, #itemplate 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.
version.delete() function to allow scripted deletion of versions in the version history. (docs)
ActionLog script object used to read and manipulation entries in the Action Log. Generally accessed from the
draft.actionLogs property. (docs)
/scandocument URL scheme. (docs)
editor.scanDocument() -> string function. 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)
/create URL 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
attendeesarray to access (readonly) attendee list.
availabilitystring with values
*Fix:- Drafts set in the editor via
editor.load should get added to recent drafts list.
*Fix (iOS):- Messages app background in dark mode had issues.
loadActionBar URLs 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.
© 2012-2022 by Agile Tortoise, Inc.
Drafts is a registered Trademark of Agile Tortoise, Inc.
Privacy | Terms