Things provides four actions for Apple’s Shortcuts app. Here’s an in-depth look at their parameters.

When you create a shortcut, you’ll need to add one or more actions that define what should happen when the shortcut runs. Things provides you with the following four:

These actions are your building blocks. They can be used to create simple shortcuts, just for Things, or you can string them together with actions from other apps in more complex workflows.

Each action has several parameters. You can preset those parameters, so that their values are always the same, or you can use variables to input data dynamically each time your shortcut runs.

Let’s take a look at what parameters are available for each action.

Add To-Do

Creates a new to-do.

Add
The title of the to-do to be added.
List
The project or area the to-do should be added to.
When
The date you plan to work on the to-do. Include a time if you want to be notified. While this field does allow for variables like “tomorrow” or “in 2 days”, it does not use the same Natural Language Parsing found inside of Things itself. This means you can’t target Someday. If you prefer Things’ parser, use a Things URL.
Deadline
The date the to-do must be finished by. Does not support a time value.
Tags
Any tag(s) to be applied.
Status
The to-do will be Open (incomplete) by default, but you can opt for Completed or Canceled.
Edit in Things
Enable this if you want to manually add extra info at runtime. Will force Things to open.
Notes
Any notes to be added inside the to-do. Supports Markdown.
Checklist
Any sub-tasks to be added inside the to-do. To add multiple, use newlines. Supports Markdown that does not contain newlines.
Show When Run
Whether or not the action’s result should be shown in Siri’s UI at runtime. Irrelevant if Edit in Things is enabled.

If you want to reveal the to-do in Things after it’s created, connect a Show To-Do action.

Show To-Do

Used in conjunction with Add To-Do; it simply reveals the to-do in Things after it’s created.

Show
The to-do to reveal in Things. Use Select Magic Variable to connect it to an Add To-Do action.
Show When Run
Irrelevant for this action because Things will be forced to open.

Show List

Launches Things and displays the specified list.

Show
The list that will be shown when Things opens. Note that you can also target invisible lists by searching for them: Tomorrow, Repeating, All Projects, and Logged Projects.
Filter by Tags
The tag(s) the list should be filtered by after it opens.
Show When Run
Irrelevant for this action because Things will be forced to open.

Run Things URL

Under the hood, all of Things’ actions are invoking Things URLs. The above three actions cover the most common use cases, but if you need more power you can use Run Things URL to utilize the full scheme. The benefit of using this action (rather than Safari’s Open URLs action) is that it can call the URL in the background without forcing Things to open.

Things URL
The URL. Looks like things:///add?title=Milk. Can contain variables. Some commands require your auth-token.
Show When Run
Whether or not the action’s result should be shown in Siri’s UI at runtime. Irrelevant if the URL’s reveal parameter is true.

To learn about Things URLs, read our documentation. We also provide a Link Builder to help you properly construct your URLs.


For more information about Things’ integration with Shortcuts, and to download some examples, see this page.