Link Search Menu Expand Document

Mac Beta Changelog

Visit the Beta Program page for details about participating in the beta. These notes reflect changes in the current beta cycle, since the last App Store release of Drafts.


  • Fix: Possible crashing in template engine


  • Change sort order of trash to use accessed date/descending to make it easier to find and restore items recently added to the trash.
  • Locale selection menu in dictation and transcription now remembers recently use locales and sorts them to the top.
  • A variety of performance improvements.


  • Transcribing speech from video files is now supported as well.
  • Audio transcription features now handle long transcriptions better. Still would not necessarily recommend it for transcribing really long files, but I threw an full 2 hour episode of ATP at it and it worked. Because of the system limitations on speech recognition duration, this works similarly to long dictation in Drafts, by chunking the input into 1 minute segments, and adding a divider to mark the transitions between chunks.
  • “Toggle Flag” keyboard shortcut should work in capture window (shift-command-L)
  • Share extension should handle case where URL is passed as raw data (example Reeder app sharing).


  • PDF text extraction. Try to import/open a PDF in Drafts, and Drafts will offer to try to extract text from it into a draft. This will only capture real text in the PDF, not text in images. Obviously, the usefulness of this varies greatly with the source PDF, but can work well to extract text from straight forward text-heavy documents. I have not thrown a wide variety of PDFs at it yet, but seems very fast and accurate for most cases.
  • [[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: Capture clipboard global keyboard shortcut was not working on older macOS versions.


  • Audio transcription
    • Added ability to transcribe speech from a pre-existing audio recording.
    • Uses system speech recognition, just like dictation, so supports dictation commands for punctuation, etc.
    • To use:
      • New “Editor > Transcribe Audio” menu command (tap and hold on “+”) to open transcription interface and select audio file, or…
      • Simply open/import an audio file, or drop it on the Drafts icon, to be presented the option to attempt transcription.
      • New editor.transcribe() script method, opens transcription interface, and returns string representing the transcribed text
    • Works best with simple, single person recorded speech, like a voice memo. It will try valiantly to transcribe other things, too, but results may vary in their usefulness.
  • Fix: Possible fix for issue appending to files in Bookmark folders from different devices.


  • Fix: A few specific action icons would cause problems when the action/workspace they were assigned to was displayed in a widget.
  • New: “Last Draft” widget command.
  • Change: Create additional tab stops in editor
  • Fix: Widgets not functioning properly on Big Sur.


  • Build with Xcode 13.1 RC, restore macOS 12 specific functionality which has been disabled, including Shortcuts support.


  • Improve template processing for static autocomplete items. Now processes with current draft in context.
  • Better refresh of global autocomplete item changes coming in via sync.
  • Better VoiceOver labelling in autocomplete forms.
  • 28.2.10

  • New: Global Autocomplete Suggestions.
    • Configured in “Aa” Editor Preferences screen (Autocomplete tab).
    • Allow you to create snippets that can be selected and inserted via drop-down autocomplete while typing.
    • Use the “Trigger” option to set the string that will be recognized to trigger the drop-down.
    • Recommand using a unique trigger string at least 2 characters long.


  • More tweaks to autocomplete drop downs.
  • Build with Xcode 13b5 since Xcode 13.1b seems like it’s not going to be a thing, and I want to test Shortcuts on Mac.


  • Add [[ link autocompletion to default Markdown, GitHub Markdown, and MultiMarkdown syntax definitions.
  • Add << transclusion autocompletion to default Markdown, GitHub Markdown, and MultiMarkdown syntax definitions.
  • Fix: Crash triggering auto-complete on blank draft.
  • Use recent drafts as default options for draft-based autocomplete
  • Fix: /open URL with title param would not properly find drafts with “:” in the title parameter.
  • Better logic to position autocomplete dropdown.
  • Misc. general improvements to autocomplete.


  • Initial support for auto-complete. See beta Slack for details and example syntax.


  • Improve efficiency of widget workspace count calculation.
  • Address some VoiceOver issues.


  • Prevent case where sending file to share extension would not capture content, or duplicate content.
  • Change to find/replace regular expression configuration to support replacement of positive lookahead constructs.
  • Fix: Case where an internal link by title could find drafts that had the query title string in some place other than the first line.
  • [[hashtags]] template tag should replace spaces in tags with “-“.
  • Fix: Last line in action script editor clipping.


  • Build with Xcode 12.5.1 for release, as macOS 12 SDK is not ready.
  • Note that Shortcuts support does not work in this build, support will return when building with Xcode 13 again.


  • preferredLightTheme: Theme and preferredDarkTheme: Theme properties on the Workspace script object to get/set themes associated with the workspace.
  • Issue with list result types being returned from an AppleScript.


  • New toolbar items (optional, add in toolbar customization) for details, preview, arrange, focus mode, and link mode.
  • Layout issue in Bookmark preferences.


  • Better activation of Share extension for different text/file selections.
  • Fix: A couple of crashers on older OS versions.


  • Modified behavior of share extension to work more like iOS version opening a capture window pre-filled with the shared content, allowing you to append/prepend to other drafts, as well as confirm/edit the content before capture is completed.
  • New /capture URL and “Show Capture” shortcut action. Display a new capture window (like used in Share extension) as a modal with optional initial text/tags.
  • “Send to Drafts” Service menu entry re-named “Capture to Drafts”, and new “Capture to Drafts with Options” service added which displays capture window.
  • [[hashtags]] template tags. 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.


  • New option when importing a .draftsExport file to select whether to update existing drafts with matching identifier, or import all drafts as new.
  • Scrolling issue in capture window when it was sized small.


  • /create_shortcuts_action URL scheme now works in Mac version.
  • Improve sync logging for a couple of edge cases.
  • Display actions in quick search based on action bar configuration.
  • “Show in Finder” buttons on Preferences > Backup screen were not working properly.
  • More tweaks to “What’s New” screen. 2


  • New “What’s New” screen accessible via Settings > What’s New (iOS) or Help > What’s New (macOS)
  • Fix: Erroneous iCloud quota warning might be displayed.
  • Command-Click on a link to another draft ([[wiki-style]] or link mode) will open it in a new window.


  • Many minor UI tweaks and improvements around app.
  • Tweaks to draft detail (i) layout, add read time calculation.
  • “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.
  • When opening action editor, select first step for editing automatically in step detail.
  • New: version.delete() function to allow scripted deletion of versions in the version history.
  • New: ActionLog script object used to read and manipulation entries in the Action Log. Generally accesses from the draft.actionLogs property.
  • Fix: Find next/previous via Edit > Find in main menu not scrolling new result to visible.


  • Shortcuts for Mac support on macOS 12 beta. The full suite of Shortcuts actions provided by the iOS app are available on Mac, with the caveat that at this time, the shortcuts are not cross-platform. Apple has promised this functionality for cross-platform apps, but it is not available yet in the OS betas. For now, Drafts shortcuts created on Mac will show as “unknown actions” on iOS, and vice versa.
  • Capture window now saves recent append/prepend drafts selections for easy selection of recents for re-use.
  • /open and /create URL schemes now support several additional parameters to configure the environment:
    • showDraftList [true/false]
    • showActionList [true/false]
    • loadWorkspace, loadActionGroup, loadActionBarGroup: take names of valid group/workspaces and applies them
  • Redesign search fields over draft and action list.
  • Allow tap on background to cancel prompt if it is cancellable.
  • Fix: Refactor the next-previous button logic because it was not updating properly in some cases.
  • Fix: Link mode button not showing state properly.
  • Fix: List options in filters pane not working on iOS 14.
  • Fix: Markdown syntaxes not recognizing [ref][links] with space.
  • Build with Xcode 13/iOS 15 beta SDK.


  • Fix: A couple of minor Google Task and Microsoft To Do related fixes.
  • Fix: Better support for import of exported files from Drafts 3 or earlier


Google Tasks integration

Added two action step types and scripting support for working with tasks and lists in Google Tasks (tasks integrated with GMail, on in Google Task apps on iOS)

Action Steps

  • Google Task: Creates a single task in Google Tasks. Similar to existing “Reminder” action, has templates for task title and notes, and ability to set the target list to add the task.
  • List in Google Tasks: Adds tasks to (or creates, if needed) a list in Google Tasks, one for each line of the draft. Similar to existing “List in Reminders” action.


New GoogleTask script object to work with the Google Tasks API. Details in the beta scripting docs. Support for working with lists and tasks as well as a generic request function to make direct calls against the API. Requires some knowledge of the API and what it expects to send/receive, but all features of tasks can be accessed, allowing setting of due dates, reminders, etc., by constructing the proper objects.


Microsoft To Do integration

Added two action step types and scripting support for working with tasks and lists in To Do (

Action Steps

  • Microsoft To Do: Creates a single task in To Do. Similar to existing “Reminder” action, has templates for task title and notes, and ability to set the target list to add the task.
  • List in Microsoft To Do: Adds tasks to (or creates, if needed) a list in To Do, one for each line of the draft. Similar to existing “List in Reminders” action.


New MicrosoftToDo script object to work with the To Do API. Details in the beta scripting docs. Support for working with lists, tasks and linked resources, as well as a generic request function to make direct calls against the API. Requires some knowledge of the API and what it expects to send/receive, but all features of tasks can be accessed, allowing setting of due dates, reminders, etc., by constructing the proper objects.

Example Actions

Example action group available as unlisted in the directory


  • Script changes:
    • Event object properties:
      • identifier
      • attendees array to access (readonly) attendee list.
      • availability string with values busy, free, tentative, unavailable, notSupported
    • Reminder object properties:
      • identifier
  • Arrange mode has better keyboard support, including:
    • ⌘-up/down move the selected line up and down in list, related move up/down buttons and contextual menu commands.
  • Tweaks to widget themes. Properly use theme’s tint colors.
  • Fix: loadActionGroup and loadActionBar URLs were not supported on Mac.


  • New: Theme support for Widgets. It is now possible to select a light and dark theme for the widget from the built-in and custom themes you have installed in Drafts. If you create custom themes, you may wish to add the following new keys in colors.interface:
    • widgetBackground, widgetBackgroundAlternate, widgetForeground, widgetForegroundAlternate
    • If not present, these values will fall back to existing related keys: background, backgroundCollection, foreground, so existing themes should work out of the box without updates.
  • New: Theme support for Home Screen Widgets.
  • New: Dozens of new icons for actions/workspaces
  • Refactor assets to save on binary size.
  • Fix: Possible fix for editor undo stack stalling.


  • Fix: If main window is closed, badge count not updated properly when capture window created new draft.
  • Fix: Draft count and empty state not always updating properly.
  • Fix: Remember if toolbar is hidden across app restarts.
  • Fix: Address some performance issues.


  • Built with Xcode 12.5 / macOS 11.3 SDK


  • Fix: Issue with width of editor changing unexpectedly with a very narrow window.
  • Fix?: Issue where undo stack could get corrupted and undo would stop working until app was restarted.


  • New: Workspaces have options to apply themes when loaded.
  • Fix: Broken back spacing auto-match in last build.
  • Let the File > Show Preview menu command close the preview if you are already in one to allow easy toggling of a preview.
  • Tweak code block patterns in MultiMarkown and GitHub syntaxes to better support use of a background color in themes.
  • Restore missing punctuation action icons.


  • Rename “balance while typing” to “Auto-match”, and disable by default.
  • Fix: Plain text syntax returning a blank name in scripting.
  • Fix: Auto-match (nee balance while typing) could interfere with text replacement by Services.
  • Fix: Address situation where list completion and auto-match could make scroll position jump in longer drafts.


  • Fix: Actions assigned to tab/backtab would only work in main window, not in separate draft windows.
  • Fix: Balance while typing could cause problems dragging and dropping text into a drafts which started with one of the opening characters.
  • Fix: Issue selected same icon multiple times in icon select popover.


  • Change: A few updates to the indentationPatterns entries in syntax definitions to allow scope to be specified properly to make sure the indent is calculated using the right font metrics. See docs for details.
  • Fix: Custom syntaxes and themes not properly visible in main menu
  • Fix: text.url scope configured incorrectly in default themes.


  • Change: Use text.url scope for the URL part of Markdown links in built-in syntaxes. e.g.
  • Fix: Balance while typing double quotes was disabled in previous build.


  • Fix: Directory update checking should work properly now.
  • New: Added syntax validation for custom scope names
  • Fix: HTML preview window not respecting override of dark mode.


  • New: “Balance while typing” editor setting. When enabled common pairs are auto-closed when typed, or the current selection wrapped with open-close values. Supports (), [], {}, “”, ‘’.
  • Fix: scopes which applied both bold and italic traits would not work.
  • Fix: Actions which requires network access, run via URL/Shortcut, on cold start of the app could sometimes fail with a network error even though network was available.


  • New: Action Group Versions. Like action versions, but for groups.
  • New: Action Group Updating. Like action updating. Only applies to action groups installed after this update.
  • Revamp handling of directory updates a bit, so it’s consistent across actions, group, syntaxes and themes.
  • Better keyboard navigation in prompts. Up-Down, Tab-Shift tab now mostly work, along with enter to select a focused button.
  • Change: Better VoiceOver announcements for action completion messages.
  • New: identifier readonly property on Syntax object to allow comparison of syntaxes.
  • Better display of items found in Spotlight search.
  • Misc. improvements to built-in themes.


  • Fix: Directory installed syntaxes/themes not properly tracking updates.
  • Pass cleaning up descriptions/samples for built-in syntaxes and themes.
  • Implement command buttons on syntax/theme details.


  • Misc. improvements to syntax and theme import/export flow.
  • Change: A few changes to the mechanics of how syntax scopes are applied to better support fallback scopes. In particular, if a syntax defines a scope not present in the active theme, it will be ignored (previously it would have applied base attributes.)
  • Better refreshing of syntaxes and themes arriving via sync.


  • Lots of fixes/improvements around handling of custom syntaxes and themes. Please test all aspects of import/sharing/directory posting, etc. Even if you are not creating your own, it’s helpful to test.
  • New: New pink tint color option for actions and workspaces (if you already created custom themes, you’ll need to add a colors.interface.tintPink key to your themes)
  • Fix: When creating reminders with Reminders and List in Reminders action steps, only set the “note” value if it will contain content. This avoids a bug in the Reminder’s watch app that displays tasks with a blank note as having a note (Watch only, this does not happen on iOS).


  • Custom syntax and theme support. This is in its early stages, some notes:
    • Pre-release documentation on format and development process:
      • Syntaxes:
      • Themes:
      • Developer Mode:
    • Managing syntaxes and themes is currently ONLY ON MAC. Custom syntaxes can be installed and used on the iOS beta (25.2.11), and development mode is available to load and test from iCloud Drive, but the UI to manage (delete, upload to directory, preview, see errors) is not yet available on iOS. That will come soon.
    • If you are working with these, please join the Slack. Discussions will follow (details on beta page:
  • Syntax script object to work with syntax definitions. With the following:
    • readonly type: ‘builtIn’ ‘custom’ ‘file’
    • readonly name: string
    • readonly installURL: string
    • static getAll(): Syntax[]
    • static find(type: syntaxType, name: string): Syntax undefined
  • Theme script object to work with theme definitions. With the following:
    • readonly type: ‘builtIn’ ‘custom’ ‘file’
    • readonly name: string
    • readonly installURL: string
    • static getAll(): Syntax[]
    • static find(type: syntaxType, name: string): Syntax undefined
  • Draft object has new syntax property to get/set Syntax assigned. languageGrammarName is deprecated
  • app object adds lightTheme and darkTheme properties to set preferred Theme

  • Fix: Last selected range not restored when selecting draft.
  • Fix: Performance issue with filter panel open and “show only current tags” option and active tag filters.
  • Fix: When restoring workspace at app startup, do not mark it changed.
  • Fix: Action steps disabled on current platform could run when that action is used via an “Include Action” step.


  • New: Limited support for update checking and installation for actions installed from the Directory. Currently only available for actions installed after installing this update. Updates are checked and offered in the action versions screen.
    • For testing purposes: Share Action A from your actions (unlisted is fine). Install it from the directory as a separate action (Action B). If you push updates to Action A, then visit the action versions screen for Action B, it will offer the update for installation.
    • When update is select, a confirmation prompt is presented, and a backup version of the previous action state automatically created for rollback purposes.
  • Fix: If default workspace is set to select a folder tab, that selection should be applied when app is first launched.
  • Fix: crash passing invalid values to strftime
  • Change: Increase batch sizes for Spotlight indexing updates.
  • Fix: Possible fix for issue with editor margins not updating properly when running in Split View on Big Sur.


  • New: Directory now supports update notes. When updating an item (action, group, workspace) previously shared to the directory, update notes can be added explaining changes. These will be stored and displayed along with the item in the Directory.
  • Change: Remove “launch in focus mode” preference. Session will just launch with focus mode in it’s last active state.
  • Fix: Allow tags to wrap in capture window.


  • Change: Tag field will now wrap to display all tags if more tags are assigned than can be displayed on one line.
  • Fix: Force <meta charset="UTF-8"> tag to avoid preview issues with some characters. Fix was in iOS version, but did not get rolled into Mac version previously.
  • Fix: Avoid navigation bar overlapping scrollbar in editor if “always” visible scrollbars are used and the tag tray is hidden.


  • Change: Refactor implementation of toolbar buttons which toggle drafts and action lists for better VoiceOver compatibility.
  • Fix: Rewrite handling of group selection in TouchBar to avoid Big Sur bug.
  • Fix: Widget and URL commands which focus the main window should switch to the correct desktop if the Drafts window is visible on a different desktop space.
  • New: Convenience methods on Todoist object to work with Sections.
    • getSections() -> [object]
    • getProjectSections(projectID: Int) -> [object]
    • createSection(options: object) -> object
    • getSection(sectionID: Int) -> object
    • updateSection(sectionID: Int, options: object) -> object
  • Change: Automatic import tasks for reminders and inbox files should be performed periodically, not just when app is activated.


  • New: Support for color in TouchBar.
  • Fix?: Play around with some things in the TouchBar trying to address a crasher on M1 Macs.
  • New: Print step now allows setting font size for plain text format printing.
  • Fix: Crasher after closing windows.
  • Change: app.selectDraft() better remembers last selected filting/workspace options.
  • Fix: app.selectDraft() could get stuck open.
  • Fix: Focus mode button in editor not enabling properly.
  • Fix: Crash using “Run Action” from draft list context menu.
  • Fix: Focus mode button not enabling properly.
  • New: HTTPResponse script object now has headers object property exposing any HTTP headers returned with the response.


  • New: Action list option (in “…”) to display keyboard shortcuts in action list.
  • Fix: Revert to fixed height cells in quick search. Too many weird crashes in AppKit frameworks with auto-layout.


  • Big pass at improving memory usage and fixing some performance issues around the app.
  • Fix: Crasher using “Run Action” from draft list contextual menu.
  • Fix: Contextual menu on drafts in quick search was not working.
  • Change: Allow wiki-style links with headings specified to navigate to the heading within the same draft.
  • Change: Save and restore last workspace setting app launch.


  • Fix: Add warning if an action group is reaching the maximum size limit (1 MB) for a single action group’s data.
  • Fix: Memory leak when running actions.
  • Fix: Remove performance issue running actions via keyboard shortcut.
  • Change: Make loading of action icons more efficient.
  • Change: Build with Xcode 12.3


  • Change: It is now possible to use Tab and Shift-Tab as keyboard shortcuts assigned to actions.
  • Change: Rewrite of list completion, moving it to syntax definitions to allow better control. For example, TaskPaper list completion will now only complete for “- “ lines, not “* “ lines which are not part of that format.
  • Change: Simple List syntax now supports { } {-} {x} three state curly braces tasks as well as the standard [ ] [x] square bracket tasks.
  • New: “Capture Clipboard” option in menu bar and dock menu.
  • Fix: Encoding agreement issue with remote loaded content in HTML previews
  • New: editor.preferredTabString property returns the current selected tab insertion type for the editor in the form of a string. Useful for making actions respect that setting when inserting indents, etc. - will return either “\t”, “ “, or “ “.


  • New: context.addSuccessParameter(key, value) method to assign query arg parameters to be included with the x-success callback of /runAction URLs.
  • Additional keywords assigned to icons for search.


  • New: Icon keyword searching when selecting icons for workspaces and actions.
  • Fix: Timing issue which could prevent actions which open URLs from saving “after success” changes at times.


  • New: ActionGroup script object has installURL [string] property to access the shareable URL to import the group.
  • New: /getCurrentDraft URL action. Takes no parameters, calls x-success URL with parameters for the uuid, url, title, content of current draft.
  • New: Web capture template used in share extension now supports [[date]] and [[time]] tags.
  • Change: Increase allowable width of filter sidebar, and place tool tip on tag name to allow full tag name to be seen if a long tag is truncated.
  • Fix: Line height calculation problem on blank line at end of draft.
  • Fix: Issue with font baseline jumpiness when using Pinyin input of Chinese characters.
  • Fix: A couple of Big Sur display glitches.
  • Fix: Issue were a sufficient number of invisible characters in a draft could make tasks near the end of the document do strange things.
  • Change: Some refactoring of “Send to Drafts” service.


  • New: Big Sur widgets actually work now. Sorted through the remaining configuration issues. Same widgets as available on iOS.
  • Change: Re-implemented global keyboard shortcuts using a different library with better accesibility.
    • NOTE: If you have modified global keyboard shortcuts, you will need to redo those changes. They will reset to defaults.


  • Fix: Encode temp files for HTML Preview with UTF-16.
  • Change: Ability to base app icon badge on flagged instead of inbox folder of the selected workspace.
  • A bunch of housekeeping, updating some third party libraries, migrating a number from CocoaPods to Swift Package Manager, etc. Should not be noticeable, but you never know.


  • Built with XCode 12.2 RC, should match v24 release build for Big Sur.
  • Fix: When an action was run from search, it did not respect the default “After Success” setting of its action group.


  • Fix: Wiki-style title links starting with escaped forward slashes failed to find proper draft.
  • New: “Purge Transactions” maintanance task in Preferences > iCloud. Not generally necessary, but this task cleans out sync transaction log entries which have been processed, which may improve performance (not much, if any) in long-lived installation.
  • Fix: Address a deadlock issue
  • Fix: Appearrance issue with filter sidebar background.


  • New: HTML Previews can now reference local assets in the iCloud Drive/Drafts/Library/Previews folder, if it exists. Place images, stylesheets, and other resources in this folder and it’s subfolders, and previews can reference them via relative paths, e.g. <img src="image.jpg">. If the /Library/Previews does not exist, previews will continue to function as they always have. If it does exist, the html will be written to a temporary file in that directory and loaded so that the directory can be used to access other assets.
  • Change: Simplify app icon badge settings and make sure the default correctly align with default workspace settings.
  • Change: File > Export in main menu now has CSV/JSON options that previously were only available in context menu of draft list.
  • New: Add “Move…” and “Copy…” commands to action list contextual menu.
  • Back to building with Xcode 12.2b3 / Big Sur SDK.


  • Build with Xcode 12.1 GM. Final testing for v23 release.
  • Removed some Big Sur specific code. Will bring it back for in new beta cycle after v23 release.


  • New: New query tokenizer, which is used in draft list search, quick search and workspace query strings:
    • Support for title: and tag: prefixes to force query to only look for term in draft titles or tags. May be combined with exact phrase searching, so title:"My Draft" will look for only drafts with the string “My Draft” in the first line.
    • AND and OR operator support. AND is not really needed, as it is assumed as the operator at any space between terms. Examples:
      • blue OR green would find any drafts with either “blue” or “green” in the text.
      • blue red OR green would find drafts with both “blue” and “red” or only “green”.
    • Regular expression terms. Marked by wrapping a term in forward slashes (/term/). Examples (not necessarily useful ones:
      • /.*ABC.*/ would find any drafts with “ABC” in the text.
      • /\d+/ would find any drafts that start with a number.
      • NOTE: Regular expressions can be slow, consider that when using them. In most cases it would be best to use them after another filtering term, like say: projectA /.*\[ \].*/, which would filter by “projectA” first, then apply the regex, which has to scan content (example would find any drafts with incomplete tasks and a “projectA” tag), or within a workspace/tag filter so the data set is already limited (yes, you could also just search "[ ]" to find incomplete tasks, just an arbitrary example).
    • Before you ask, there is no way to group constructs for now. Hope to get to that at a later date.
    • Existing "exact phrase" and -omit still work, of course.
  • Change: If /open URL with title parameter finds more than one matching draft, the resulting search now opens with title:"value" search to limit results to only matching titles.
  • New: “Save Current” option in workspaces menu to create a new workspace based on current list options.
  • New: [[display_title]] and [[body_preview]] template tags. These match the trimmed display versions of the title and body displayed in the draft list.
  • New: draft.bodyPreview(maxLength: Int) function. Returns trimmed body preview similar to what is used in the draft list, removing first line and triming whitespace and truncating to the requested length.
  • Fix: Better quit behavior, trying to make sure any current changes are synced to cloud, if possible.


  • Fix: Drafts list width should be adjustable, not snap back to size.
  • Fix: Clicking a task in a draft open in multiple windows would not immediately update other windows as it should.
  • Fix: Scripted prompt in an action called via app.queueAction might not display.


  • Fix: Import from backup might not maintain correct modification dates.
  • Fix: Restore “Miscellaneous” category of action icons which was missing for some reason.
  • Fix: Better handle import of old actions.
  • Change: Built with Xcode 12.2b2


  • Work on Big Sur issues, mostly visual.
  • Fix: XML-RPC requests might improperly entify parameter strings.
  • Change: Build with Xcode 12.2 beta


  • Small but useful change: When searching the action list, groups appear as separators. It is now possible to double-click on those group separators to load the group in the list.
  • Fix: Fix quick search fallback to standard search on OSes that do not support quick search.
  • New: “Duplicate” swipe action in Workspace manager.


  • Change: Use new search preview text in quick search results.
  • Fix: Some layout issues in Quick Search on Big Sur.
  • Fix: Allow Edit of actions from contextual menu in an action search.
  • Change: Better step preview texts for some step types.
  • New: Update default first-install action groups.
  • Change: Better validation messages for keyboard shortcuts.


  • New: /open URL scheme will now support navigating to markers within a draft. This can be used it two ways:
    • Pass explicit marker=MarkerIdentifier parameter - intended for use when using open with uuid parameter to specify draft.
    • Include marker identifier in title parameter after a / separator, in the format title=Title%2FSectionName (%2F is / url encoded). This format is intended primary for use in wiki-style links within Drafts, such that [[Draft Title/Section Name]] will navigate directly to the “Section Name” marker in the draft “Draft Title”. If your title or marker identifier contain /, you have to escape them as \/.
    • Markers are defined in syntax definitions and are used to build the “Navigate” menu. A marker identifier will generally equate to the label displayed for the marker in the navigation menu - so, in the case of the Markdown definitions, the heading name. In the case of a Taskpaper draft, the project names, etc.


  • New: Action versioning. Available in action edit view. Allows capture and restore of snapshot versions of actions. Currently only original installation versions are saved automatically. Manual versions can be created at any time.
  • New: Workspace.showSearchPreview boolean property to toggle new search preview feature.
  • New: Added something else new. We’ll see if anyone notices it.


  • New: “Show search preview” option in drafts list options and workspaces. When enabled, if a text search is done in the search field, the body preview displayed in the list will change to show line numbers and text snippets where the matches term appears in the text of the draft.
  • Change: Drag and drop of a message from Mail will now insert not just the subject of the dragged message, but the “message:” URL linking to the original message.
  • New: The following properties of the Drafts script object, which were previous read-only, can now be modified as well: createdAt, createdLongitude, createdLatitude, modifiedAt, modifiedLongitude, modifiedLatitude. I generally would not recommend excess use of overrides for these values, but it can be useful for imports which maintain values from another system.
  • New: Backups now have a “keep” setting to control how many backups to keep, automatically sweeping older backups to avoid consuming too much space on iCloud Drive.
  • Change: Allow /workspace URL to open default workspace without pro subscription.
  • Change: Action separators can now be edited directly from action list.
  • New: Contextual menu in action group manager has new “Insert Action” and “Insert Separator” commands to add new actions directly below the selected action.
  • New: Contextual menu commands directly in action list to “Insert Action” and “Insert Separator”.


  • If running macOS 11 beta, requires dev beta 5 or greater. Should be fine on previous versions of macOS.
  • New: /actionSearch?query=TEXT URL to open directly to a search of the action list.
  • Change: The /open URL, when used with allowCreate=true should prompt about the creation of the new draft. This affect [[wiki-links]] and prevents mistyped links from creating drafts unintentionally.
  • New: Workspace script object has new installURL property which exposes the URL which can be used to share the workspace. Useful for scripted backups and sharing.
  • New: Action script object has new installURL property which exposes the URL which can be used to share the action. Useful for scripted backups and sharing.
  • Fix: Make sure smart quotes/dashes are disabled by default in find window.
  • Change: Update OAuthSwift library.


  • New: The tag filter pane can now be set to “Show All Tags”, or “Only Tags in Current Filter”. The later is a new option which filters the list of available tags to only show tags that are assigned to at least one draft in the current query in the draft list. Set via “…” options menu.
  • New: Better theme selection with previews in Editor Preferences.
  • Fix: Workspace date filters might not save if no other changes were made when editing a workspace.
  • Fix: Better handling of nested blockquotes in Markdown syntax definitions.
  • Fix: Immediately force save after a dictation session to make draft appear in draft list.
  • Build with Xcode 12b5


  • New: Workspace date ranges. It is now possible to configure start and end dates for a workspace. They are optional, and likely most useful for constructs like a “Modified Today” workspace, or similar. Ranges are date-based and can be configured as specific absolute dates or dynamic relative dates +/- n days from the current date. These are also scriptable. I will post sample code to Slack.
  • Fix: Markdown syntax did not recognize indented code blocks starting with a number.


  • First pass of visual fixes/updates for Big Sur.
  • New: Calls to console.log in HTML Previews now get routed to and saved in the action log.
  • Change: If a [[wiki-style]] title link matches multiple drafts, the app will now throw up a warning and open a search for the title to help you disambiguate your intentions and make you aware that more than one match exists and you may need to be more specific in your naming conventions.
  • Fix: Backspace key not working in some field in action editor.
  • Fix: Crash using arrange mode on Big Sur.


  • New: Keyboard shortcut assignments now support using several special keys - notably arrow keys.
  • Change: Misc. visual tweaks.


  • New: File action step has new “Tags” field which can be configured to assign Finder tags to files when writing them. Use [[tags]] to pass through tags assigned to the draft.
  • New: FileManager object has new getTags(path): string[] and setTags(path, tags) functions to get and set finder tags on files.
  • Change: Add separate quick search menu item in menu bar when available.


  • Fix: Alter method processing “after success” in actions to avoid case where it is not handled properly.
  • Change: Big Sur-ify icon
  • Fix: Crasher importing multiple files using File > Import... when the inbox was empty.
  • Change: Migrate language identification code used in RTL support to use NaturalLanguage framework.
  • New: editor.getLineRange(location, length) function. Like editor.getSelectedLineRange() but to expand a range anywhere in the text to line start/end positions.


  • New: First builds using macOS 11 beta SDK.
  • New: Preference to disable/enable custom action touchbar in editor.
  • Fix: draft.append and draft.prepend should not require separator argument.
  • Change: When importing an action, look for an existing action with the same name and offer to replace the existing action or import as a new action.
  • Fix: Memory leak in action editor.
  • Change: Support auto_reminder option in Todoist step and scripts
  • New: Draft count at bottom of draft list.
  • Fix: Better refreshing of action log window when visible and new log entries occur.
  • Fix: Recent tags used should be tracked on Mac.


  • Fix: Dropbox API compatibility issue.
  • Fix: Drag and drop of drafts could lose syntax assignment.
  • Fix: Undo in editor might not update Marked Preview.
  • Fix: Deleting action step in action editor should remove it from the detail view.


  • Change: Refactor some of the FileManager code. The write method no longer replace the file, just update contents so creation date is maintain and it interferes less with other apps using save the folders.
  • Change: Better detection of previous free trial.
  • Change: Improvements to the way workspaces are loaded in app.selectDraft


  • New: app.isPro boolean to determine if the app is pro unlocked.
  • Fix: app.currentThemeMode not always correct.
  • Fix: Regression in tag field layout.
  • New: “Insert Text” action steps should register undo point.
  • Fix: Various undo fixes.
  • Fix: Drag and drop to folder buttons in drafts list should be undoable.


  • New: Undo. Most actions on the draft list are now undoable. Trashing, moving between inbox/archive, flagging, add/remove tags, etc. (Currently Mac-only, plan to add to iOS build soon.)
  • New: app.currentWorkspace property returns a Workspace object configured as the current drafts list is configured. Note this is not the same as a named workspace object, even if you have recently applied a workspace to the list. Calling update() on this retreived copy will create a new workspace. It is recommend this be used primarily as a read-only verion of the workspace to use to pass to another function, such as app.selectDraft().
  • New: HTML Preview action step has new “Hide Interface” advanced option which hides buttons/toolbars. For use only when JavaScript with the preview will call Drafts.continue() or Drafts.cancel() in its logic to close the preview.
  • New: HTMLPreview script object adds hideInterface boolean property (as described above)
  • Change: app.selectDraft() now displays draft selection as a sheet in the current window rather than as a standalone window.
  • New: Edit > Find in Action List (opt-cmd-L) menu command.
  • Change: Change “Move to Trash” keyboard shortcut to avoid conflict with delete to beginning of line text shortcut.
  • Fix: Clicking on a non-HTTP link in an HTML Preview should close the preview as if the cancel button were pressed.


  • New: HTML Preview script steps now provide access to the JavaScript functions below, which can be called from scripts embedding in the preview document to pass values out for use in Drafts script steps, and control flow. Using these features, you can build user-interfaces for actions using HTML forms, and gather and submit data or user selections for use in other script steps.
    • Drafts.send(key, value): Send data out to the action context. These values will be available to subsequent scripts using the context.previewValues object. So, if you call Drafts.send("mydata", {"a": 1, "b": true}) in your preview, you can later retrieve those values in a script step using context.previewValues["mydata"].
    • Drafts.continue() and Drafts.cancel(): Equivalent to pressing the continue/cancel buttons in the preview UI. Allows automatic continuation of script with a form submission, for example, in the HTML document.
    • I will post examples to the beta Slack.
    • (This also works in scripted previews using HTMLPreview)


  • New: app.selectDraft() can now optionally take a workspace parameter to set the initial search/filtering in the select window.
  • Change: Improve keyboard navigation and selection in Drafts select window (used in Capture window and app.selectDraft()).
  • Fix: Web capture template not saving changes properly.
  • Fix: If focus mode was disabled in secondary windows, the new draft creation timeout would fire too quickly in those windows when returning to the app.
  • New: draft.append(text, separator) and draft.prepend(text, separator) convenience functions on draft object. separator is optional and defaults to a line feed.


  • Fix: Starting a line with a smart quote could temporarily align it to the right.
  • Fix: Editing an action from the results of a search in the action list should refresh the search to get the new version of the action.


  • New: Draft.queryByTitle(title) returns array of drafts matching the title. This exposes the logic used by internal links to find drafts with a specific title.
  • New: Link definitions now support [[url:]] option to enable a full URL link external to drafts.
  • Change: Fine-tune the link matching regex a bit to avoid some nesting oddities.
  • Change: Locating draft by title should not be case-sensitive.
  • Fix: Address scroll bar clipping content in prompts.
  • Change: Misc. minor visual tweaks.
  • Fix: If Action Log window had been closed and reopened, it might not update detail properly when selecting log entries.
  • Change: Built with Xcode 11.5


  • Fix: Loosen title matching to allow for blank lines at the beginning of the draft.
  • Change: Add command-L keyboard shortcut for “Find in List”
  • Fix: Line numbering issues with typewriter scrolling enabled.


  • Change: [[Title of Draft]] links now supported without requiring teh d: prefix.
  • New: File action step has new “Maintain dates” option which will set the creation/modification date of the newly created file to match those of the current draft. When the action create a new file, creation and modification will be set - if it is appending/prepending to an existing file, only modification date will be updated.
  • New: File action step has new “Maintain dates” option which will set the creation/modification date of the newly created file to match those of the current draft. When the action create a new file, creation and modification will be set - if it is appending/prepending, only modification date will be updated.
  • New: FileManager has new getCreationDate(path), getModificationDate(path), and setCreationDate(path, date) and setModificationDate(path, date) functions. Self-explanatory, I think.
  • Change: Opening a draft via /open URL should restore the last selected position in the draft.
  • Fix: “Export” action step should only add .txt file extension if the filename template did not already provide an extension.
  • Change: Make {== highlight ==} CriticMarkup syntax in MultiMarkdown more prominent in some of the themes.
  • Fix: Multiple tasks [ ] marks on the same line without text between them could do some weird stuff when tapped.
  • Fix: Clicking task marks should be undoable.
  • New: “Last Draft” < toolbar button to go back to the last draft loaded in the editor.


These release notes rollup changes since the 19.2 release. These features will be released as 20.0 soon.

What’s New

  • Link Definitions in Markdown syntaxes to support cross-linking between drafts,and executing basic Drafts commands. When embedded in a draft, these become tappable links which open URLs as described below:
    • [[d:Title of Draft]] : creates a link which will open a draft by title (first line) when clicked/tapped. Will create draft with the title if it does not exist.
    • [[u:UUID-OF-DRAFT]] : creates a link for specific draft by UUID to allow exact linking. Will not create a draft, it must exist.
    • [[s:Search Term]] : creates a link which will open a quick search to the specified search
    • [[w:Workspace Name]] : creates a link which will load the named workspace
    • [[google:Search term]] : Opens a Google search for “Search term” when clicked/tapped.
    • [[wikipedia:Search term]] : Opens a Wikipedia page for “Search term” when clicked/tapped.
    • [[bear:Title of Bear Note]] : Opens a note titled “Title of Bear Note” in Bear, if it exists.
  • “Typewriter Scrolling” option which fixes the cursor position in the middle of the editor, moving the text as you type. Enable via “Editor > Typewriter Scrolling” in the main menu.
  • Navigate menu (down-arrow in top right) now has additional options for navigating to recent drafts.
  • Scripting additions:
    • Most JavaScript objects now support new keyword. So new Draft() now works in lieu of Draft.create() (old syntax still works).
    • Draft object additions and changes:
      • title property now strictly returns first line of draft
      • displayTitle property returns cleaned up title as it would be displayed in draft list, removing Markdown header characters, etc.
      • lines property returns content as array of string split on line feeds.
      • editor.recentDrafts property returns array of recent drafts loaded in the editor, with the most recent previous draft as the first index. Useful for navigation in actions.
    • app.openInNewWindow(draft) script method. (iPad/Mac). Pretty self explainatory I think.
    • Scripting access to editor navigation markers, as displayed in the Navigation window/menu. Allows for the creation of actions which navigate within the current document.
      • editor.navigationMarkers: Array of navigation markers available in the document.
      • editor.navigationMarkerAfter(location: number) and editor.navigationMarkerBefore(location: number) convenience methods to get the next/previous navigation markers relative to a location in the text.
      • navigationMarkers are objects with the following properties:
        • location: start location of the range
        • length: length of the range
        • prefix: Identifying prefix for the marker (like H1, H2 in Markdown syntax) as defined by syntax
        • label: Identifying label for the marker.
        • level: indentation level of the marker.
        • I will post example actions to navigate to the next/prev markers to the Slack.
  • Contextual menus on drafts in Quick Search results.
  • Add option to copy title to clipboard in locations where there are copy options.
  • /open URL scheme now supports additional “title” and “allowCreate” parameters that allow drafts to be found and opened by title - and, optionally created as a new draft if a matching title is not found.
  • Arrange mode now supports expand/collapse modes like iOS version.

Other Changes and Updates

  • Fix: Better routing of URLs in multiple windows to support new links better.
  • Change: Add horizontal rule match to Markdown syntax definitions (***, —).
  • Fix: Editing templates in actions should default to smart quote/dashes disabled.
  • Change: Audited reserved keyboard shortcut list to include some additional shortcuts that create conflicts on Mac.
  • New: Drafts in quick search results have contextual menus with common commands.
  • Change: Allow previews to open non-http links.
  • Fix: Submitting invalid data to FileManager.writeJSON could crash the app.
  • Fix: State of options in main menu Editor menu not always correct when viewing drafts in secondary windows.
  • Fix: Crash clicking in empty space in manage actions window.
  • Fix: Editing templates in actions should default to smart quote/dashes disabled.
  • New: Context menu in drafts in draft list and quick search add “Open in New Window” option.
  • Fix: Specifying locale when calling editor.dictate() did not set the requested locale properly.
  • Fix: Clipping issue in editor preferences.
  • Fix: Change the current draft’s syntax in script would not update syntax selection dropdown menu.
  • Fix: Better handling of empty state in arrange mode.


  • New: Capture window “Open” button (⌥-⌘-⏎). Performs save and closes capture window, opening Drafts to the newly created draft.
  • Fix: Syntaxes (like TaskPaper) which apply strikethough styles, the style might not get cleared if edits (like removing @done from a task) no longer required it.
  • Fix: Problems reordering actions in the action list in groups with hidden actions.
  • Fix: Force fixed size on draft results in quick search, attempting to work around layout crasher with some search results.


  • New: Workspaces can be shared via directory (still not visible in public site, but can be posted).
  • Change: Refactor and simplify Action Directory integration code (preparing for sharing of syntaxes and themes).


  • New: Editor settings have new tab key options, allowing you to select whether the tab key inserts a tab, two spaces or four spaces.
  • Fix?: A number of layout tweaks to quick search in hope to avoid occassional crasher.
  • Fix: Issue with editor not reflecting changes to a draft made in a scripted action if the draft was loaded in the script via Draft.find instead of referenced as the global draft variable.
  • Change: Refactoring a few more capabilities of the syntax/theming engine. Let me know about any syntax highlighting issues.


  • Fix: Exporting a file from Run AppleScript editor should export with .applescript file extension.
  • Change: Improved keyboard navigation in and initial positioning of find panel.
  • Change: Make insertion point more prominent in the editor.
  • Fix?: Possible fix for case where quick search can get stuck beach balling for some users.


  • Fix: Better live updating of changes if the same draft is open in multiple windows.
  • Fix: Crash dragging action step from one action edit window to another.
  • Fix: Changing only some advanced settings in the action editor, and nothing else, could result in the change not being saved.
  • Fix: Quick search sheet should remember it’s size if resized.
  • Fix: Down arrow from search field in quick search should focus results.
  • Change: Quick search should remember last search.


  • New: FileManager objects now have baseURL and basePath properties which return the full file:/// url or POSIX path to the base directory used by the FileManager.
  • New: FileManger objects now have writeJSON(path, obj) and readJSON(path) convenience functions for saving or restoring JavaScript data.
  • Fix: title property was not getting passed properly to AppleScript steps.
  • Fix: Tweaks to the method of compiling AppleScripts to avoid sandboxing issues for some applications.


  • New: ShellScript script object to execute shell scripts (Mac only).
    • execute method returns boolean for whether script was run. Takes an optional array of string arguments to pass to the script.
    • After running, the ShellScript instance will have values in standardOutput and/or standardError properties matching the output of the script.
    • Example:
let script = `#!/bin/bash
echo "Total arguments : $#"
echo "1st Argument = $1"
echo "2nd argument = $2"
let runner = ShellScript.create(script);

if (runner.execute(["1", "2"])) {
    alert("STDOUT: " + runner.standardOutput + "\n\n" + "STDERR: " + runner.standardError);
else {
    alert("STDOUT: " + runner.standardOutput + "\n\n" + "STDERR: " + runner.standardError);
  • New: Additional commands in quick search
  • Fix: “-“ button for deleting actions in action manager did not work properly with multiple selections.
  • Change: Allow shift-cmd-F to close quick search if it is already open (esc works, too)
  • New: Better explanation when requesting permissions for AppleScript step.
  • New: draft record passed to AppleScript execute function now includes permalink property.
  • Change: Misc. polish in quick search.


  • New: Quick Search. This is a pretty big one, testing and feedback is welcome.
    • This a macOS 10.15.1 or greater feature.
    • Quick search can be opened from toolbar, Edit > Find > Search all or via shift-command-F keyboard shortcut.
    • Supports quick search of drafts, workspaces, actions, and a set of commands (only a few defined so far).
  • app.showQuickSearch() script method to allow triggering quick search from a script.
  • Fix: “after success” filing options on actions could cause the next draft to be selected in other windows than the one triggering the action on iPad.
  • New: app.showDraftInfo(draft?) function to display details of a draft.


  • New: AppleScript support. See working docs for details
    • New: “Run AppleScript” action step.
    • New: AppleScript script object for calling AppleScripts from JavaScript.
    • New: Basic AppleScript support for creating new drafts. Example: tell application "Drafts" make new draft with properties {content: "my draft", tags: {"blue", "green"}} end tell
  • New: Marked app streaming preview support. If enable in Preferences > General, the editor will live update the stream Marked watches in it’s “Streaming Preview” window.
  • Change: Searches now also search tag names in addition to searching full text.
  • Fix: “Manage Actions” window did not behave properly in full screen mode.
  • Fix: Several crashes related to open and closing additional drafts windows when the app first launched.
  • Change: Improve identification of HTML tags in Markdown syntax.
  • New: Additional Workspace script object properties:
    • loadActionListGroup (ActionGroup)
    • loadActionBarGroup (ActionGroup)
    • loadFolder (“inbox” “archive” “trash” “flagged”)


  • New: Several additional icon grouping for use on actions and workspaces.
  • Fix: Crash using “Run Action” from contextual menu on draft list.
  • Fix: Clearing a keyboard shortcut on an action might not save if no other changes were made to the action.
  • Change: The /workspace URL action can now accept the name=Default argument to clear filters and load the default workspace.
  • Misc. other reliability and performance improvements.


  • A few last tweaks getting ready for release.


  • New: File > New with Syntax menu items to create new drafts with a specific syntax already assigned.
  • Fix: Work on several odd-ball crashing cases.
  • Change: Audit of how/when draft version history entries are automatically created. Should be reliable capture some state changes and avoiding duplicate versions.
  • Fix: Targeting specific OneNote notebook might not work in some cases.
  • New: Added ability to view action log for only the current draft, from popover below editor.
  • Fix: Issue with reordering action groups not working properly with certain data sets.
  • Fix: Possible issue reordering workspaces with certain data sets.
  • Fix: If a draft was selected for appending in the capture window, then opened and editing in the main window, returning to capture and appending additional text without reselecting the draft for appending could result is overwrite main window edits.
  • Change: Periodically reset sync log if logging is enabled to prevent excessive log sizes.


  • New: Tappable tasks in TaskPaper syntax. Test tasks in general, because this required some refactoring of how tasks work.
  • Change: Refactor some underlying framework names.
  • Fix: Global shortcut for main window should bring app to front if window is already visible but not active.
  • Fix: Work on a couple of rare crashing issues.
  • 17.3.3

  • Fix: Issue with text flicker and dissapearance when clicking task marks.
  • Fix: Be less agressive reloading draft list on some functions to avoid visual glitches reloading list.
  • Fix: Layout glitch changing margins in editor preferences.
  • Fix: Workaround RTL alignment issue for strings beginning line with a smart quote.


  • Fix: Toolbar items in main window were not activated properly in the overflow menu which appears when the window is too narrow to display all items.
  • Change: Increase priority of action pane toolbar items so they are less likely to be collapsed into overflow menu when window is too narrow.
  • Fix: Select action view should remember last selected action group.
  • Fix: Better position action selection window when using “Run Action” from drafts list context menu.
  • Fix: Changes in the editor could be overwritten if using the context menu on the draft list to alter the same draft before a save occured.
  • Fix: Background colors applied by syntax highlighting (as inline code) might not get cleared immediately if the text changed it ways that should disable that background color.


  • Change: Allow ESC key to close capture window (without saving).
  • New: Reminder script object has new dueDateIncludesTime boolean property. If true, the time components of the dueDate will be ignored allow Reminders to be set to be due on a date without assigning a time.


  • Fix: Properly update editor margins when entering and exiting full screen mode.
  • Change: Mail.send and Message.send APIs now work on Mac for foreground messages/mail.
  • Change: Updates to default action groups.
  • 17.2.2

  • New: Workspace sharing. Ability to import/export Workspaces via URL or file.
  • Change: Reworked sharing buttons in actions and actions groups management screens.
  • Change: Better logging in Dropbox actions.
  • New: Share scripting methods now implemented for Mac.
  • Change: OneNote actions will now prompt for the selection of a notebook if a notebook name is not specified and the default notebook cannot be determined.
  • Fix: Text views in prompts did not scroll properly with longer texts.


  • New: TouchBar support when available. Uses same configuration options as Action Bar (but can display different action group).
  • New: Medium action step type to post to New: Medium script object to support scripting Medium API - docs coming.
  • Change: A few tweaks to the new monochrome themes.
  • New: Script steps now have “Allow asynchronous execution” option. When enabled, the action will wait for a call to script.complete() to know if a script step is finished. This allow use of async/await, Promises and other async function calls…but your script must call script.complete() of the action will timeout and fail after 60 seconds.
  • Fix: Action selection window not picking up theme properly if not using system dark/light setting.
  • New: CallbackURL objects have a read-only url property to debug the URL which will be used with the configured parameters.
  • New: Two new monochrome editor themes.


  • New: “Run Action” option in drafts list contextual menu.
  • New: Highlight insertion point option to draw different background for current cursor position.
  • New: Editor setting to limit max characters per line. Works along with margin settings to determine a maximum line length.
  • Fix: Hiding action group from list should not remove it from main menu.
  • Fix: Filemanager.readString would not return undefined properly when file was not found.
  • Fix: Inaccurate action directory URLs used for opening actions posted to the directory.
  • Fix: Appending to a flagged draft from the capture window could unflag the draft.
  • 16.1.2

  • New: Print action steps can now specify page margins (in points). Details
  • Fix: Triggering a dictation action on unsupported OS version would report problem, but not properly finish the failed action.
  • Change: Switch to custom link identifier in Link mode to fix a few issues with URL highlighting with data detectors.
  • Change: Update subscription pitch screen.
  • Fix: Vertically align select items in prompts to avoid clipping.
  • Fix: Possible fix for issue hidding action bar on 10.13 (High Sierra)
  • Change: Tighten authorization scopes requested by Gmail actions based to avoid Google verification issue.
  • Fix: Fix for issue where scripted alert might not appear when action was run by being queued in another action.
  • Fix: Issue that could prevent extended dictation from working properly if the system timed out listening.


  • Change: Filtering unsupported actions in action list should respect whether unsupported steps are enabled for current platform.
  • Fix: Sync issue which could result in conflicting changes made offline and online creating inconsistent state for a draft between devices…particularly non-modification changes like archiving/flagging.
  • Fix: Action list might appear blank when first shown on Mac running High Sierra (10.13).
  • Change: Improvements to action list context menu to better handle separators and allow “Manage Group” option.
  • New: Add help button which links to scripting reference in script editor.
  • 15.5.26

  • Fix: Fix for case where sync could stall due threading issue, particularly on iOS 13, but also possible on other versions.
  • Fix: Display issue with action separators in action manager with non-system theme.
  • New: Action Groups can be reordered by drag and drop in action manager.
  • Fix: Issue saving changes to action group icon and tint color.
  • 15.5.25

  • New: “Change Syntax…” command in File menu and draft list context menu.
  • Change: Include full action name in tooltip.
  • New: Support for additional URL actions, including /arrange, /runAction, and support for the action parameter on other actions (where supported).
  • Fix: Image alignment issues in the main menu Actions menu.
  • New: Contextual “Insert Template Tag” menu item editing templates in the action editor.
  • 15.5.22

  • New: Additional swipe and context menu actions in the action manager (including functions to move/copy actions).
  • New: Drafts can be dragged from draft list onto actions in action list to run actions.
  • Change: Rework some “Window” menu commands in the main menu.
  • New: Add “Manage Actions” option to action bar group selection menu.
  • Change: Update about window.
  • 15.3.21

  • New: File and reminder import features, configured in preferences, to automatically import from a reminders list and/or text files in the “Inbox” folder in iCloud Drive/Drafts/Inbox.
  • Change: Tweak to priority of operations in sync to attempt to prevent some issue on iOS 13.
  • Change: Do not update flagged status of draft when appending from the capture window.
  • 15.3.20

  • New: Support “tagged” filtering in tag filters and workspaces. The inverse of the existing “untagged” special value - will match any draft with one or more tags assigned.
  • New: Previews now support printing, and “Copy Rich Text” function.
  • New: HTML Preview action steps now support printing and “Copy HTML” and “Copy Rich Text” functions.
  • New: Swipe actions and context menus for action steps in action editor.
  • Fix: Periodic backup of action groups not running even though it was configured.
  • Fix: Changes to action “after success” settings not saved properly.
  • Change: In Markdown syntaxes, continue markdown quotes like lists are continued.
  • New: Include draft syntax in (i) draft detail summary
  • New: “Inbox swipe defaults to trash” option in “…” draft list options menu.
  • Change: Add “don’t show again” option for plain text warning in HTML mail actions.
  • Fix: Assign better window titles to draft windows.
  • Change: Allow one level of undo if the “clear” button is pressed in the Capture window accidentally.
  • Fix: Action list separators did not always adjust to light-dark mode changes properly.
  • New: Hover tooltips in action list to show keyboard shortcuts.


  • Fix: Quick fix for crasher with some text operations.



  • New: Initial beta release with Action support.
  • New: All draft windows are now full main window instances with access to the drafts and action lists. They will be opened with panels closed, but can open them and access those features.

Other Changes and Fixes

  • Fix: Significant rewrite of some of the code behind updating the drafts list to try to address a few nagging issues with items temporarily dissapearing from list and similar.
  • New: Workspace configuration of action groups and action bars to load with Workspace now supported.
  • New: Ability to configure and run action group backups in Preferences.
  • Change: Streamlining pass through syntax highlighting code. Improves performance and resolves (hopefully) a few little oddities.
  • Change: Update to the latest OAuthSwift library.
  • Fix: Add calendar access entitlements to allow calendar permissions to be requested.
  • Fix: Opening a draft from the archive in a separate window could result in a blank window.
  • New: Credentials panel in Preferences.
  • New: Standard draft windows can now be floated over other apps.

Download on App Store Download on Mac App Store

© 2012-2022 by Agile Tortoise, Inc.
Drafts is a registered Trademark of Agile Tortoise, Inc.
Privacy | Terms