OmniFocus 3 Reference Manual for iOS

Appendix D

iOS Integration

In addition to interacting with Siri, OmniFocus takes advantage of other iOS features to offer convenient access no matter where you are on your device. This appendix describes how OmniFocus works with other native iOS features to deliver the most productive experience possible.

Send to OmniFocus

When you’re in another app and you’re inspired to add something to OmniFocus—whether it be a webpage in Safari, a picture in Photos, or a file from another app that supports sharing—you can send it to OmniFocus.

Opening the contextual menu on a text selection in Safari.

Tap Share the iOS Share button, or choose Share from the contextual menu of a selection, and choose OmniFocus from the list of apps that appears. If it’s not there, swipe left on the list and tap More to add it.

Adding OmniFocus to the list of iOS Share destinations.

You’ll get a simple “quick entry”-style form to create a new item, with a field for its title, notes, project, and tag. The item is populated with some information relevant to the data you’re sharing back to OmniFocus (website URLs in the note field and title pre-filled in the title field, for example). Edit these if you want, and then tap Save when you’re ready to send it to your Inbox.

Sharing to OmniFocus using the OmniFocus quick entry-style share sheet.

Today Widget

Swipe down from the top of the screen anywhere on your device, then swipe to the right (or swipe right from the first pane of the iOS Home screen), and you’ll see what’s going on today: a collection of widgets that iOS presents as a curated set of data relevant to your current place and time.

The Today view with the Weather widget shown.

You may see some Calendar entries, perhaps a Reminder or two, and you’ll notice a button at the bottom of the screen labeled Edit. Tap it and you’ll be brought to the edit screen, where you can add other custom widgets to your Today screen—OmniFocus among them.

Adding the OmniFocus widget to the Today view.

Tap the green plus icon next to OmniFocus and it’ll be added to the list of extensions shown on the Today screen. Use the reordering handles on the right to change their order, and when you’re set, tap Done.

Reordering widgets in the Today view.

From now on you’ll see OmniFocus items that are relevant today alongside events of current interest from other apps, and you can check on their status (or check them off as complete) from anywhere on your device.

The OmniFocus Today widget on the Today screen.

On a device with 3D Touch, press the OmniFocus app icon on the iOS Home screen to access OmniFocus Today widget and other quick actions. This also offers another way to add OmniFocus to the Today screen; tap Add Widget for a convenient setup short cut.

Quick actions from the OmniFocus app icon on the iOS Home screen.

The OmniFocus widget shows a single item by default (the one it deems most relevant based on your settings). Tap Show More to see an extended list of upcoming actions as they appear in chronological order.

Just beneath Show More (or Show Less) in the OmniFocus widget you’ll find the New Inbox Item the Today widget's New Inbox Item button button, which makes it even easier to add a task to your OmniFocus Inbox from anywhere on your device. Tap it to open OmniFocus with a new Inbox item ready for entry.

OmniFocus uses the Today settings to determine which items are displayed in your Today widget. Due Today is the default, but you can choose another (or multiple other) task attributes to suit how you personally describe priority in OmniFocus and put the most important things front and center.

With OmniFocus Pro, if you’d prefer to display an entirely different custom perspective in the Today widget you can choose to do so in OmniFocus Today settings.

In the Badges section of Notifications settings, you can choose to have a summary of the OmniFocus icon badge count (a badge that displays the number of OmniFocus items deemed important based on your settings) as part of the Today widget. This adds a row beneath your actions that contains the badge count and its breakdown by item type.

If you have an Apple Watch with OmniFocus installed, the display settings you choose for the Today widget apply to the OmniFocus for Apple Watch home screen and Complications as well. See OmniFocus for Apple Watch to get started with OmniFocus on your Apple Watch.

Swipe down from the center of of the iOS Home screen to open Search. When you enter a search term, iOS includes results from your OmniFocus database so you can jog your memory about a task that needs doing, or check to make sure you noted that book you wanted to read (at the same time as you look for it online).

Tap a search result from OmniFocus and it opens directly to that item in the app.

If you would rather not include OmniFocus items with your iOS search results, visit iOS Settings > Siri & Search and scroll to the OmniFocus entry there for controls to turn it off.

Notifications

With the iOS Interactive Notifications feature, you can take action on alerts from OmniFocus regardless of where you are and what you’re doing on your device.

To take advantage of interactive notifications, you’ll need OmniFocus notifications to be set up as banners. Check Notifications > OmniFocus in iOS Settings to make sure this is the case.

Use OmniFocus Sounds and Alerts settings to choose which events associated with OmniFocus items you want to cause notifications, and use the inspector to set up notifications for individual items.

Now, when you see a notification for an OmniFocus item you’ll have a couple of options:

An OmniFocus notification appears on the iOS Home screen.

Notification Details

The detail view for an OmniFocus notification alert offers the following options for interaction:

The details of an OmniFocus notification on the iOS home screen.
  • Complete—Mark the item complete, checking it off in your OmniFocus database.

  • Snooze—Delay consideration of the item for another 15 minutes. This doesn’t change its due date or defer date; it just reminds your device to check in with you again later.

For project or action group notifications, the detail view also includes a list of actions within the group, and their relevant due dates (if they differ from that of the project or group).

Details of the notification for a due project, including a list of the actions within it.

For location-based notifications, the detail view is a bit different: it doesn't offer Complete or Snooze, and instead displays a map with the tag location and a list of available items assigned to the tag. Tap the notification to view the tag and its items in the Nearby perspective.

Details of the notification when leaving a location, including a list of the actions associated with its tag.

Notification Center

If you have OmniFocus notifications set as temporary in iOS Notifications settings, they'll still be just a gesture away. Swipe down from the top of the screen to open Notification Center, with a list of all your recent alerts.

Notification Center on iOS with an OmniFocus notification displayed.

Interact with OmniFocus items in Notification Center in a few ways:

  • Swipe right on an item to Open it. This opens OmniFocus directly to the item in question where you can take further action on it.

  • Swipe left on an item to either View it, opening its notification details, or Clear it, removing the alert from Notification Center.

  • Tap and hold an item to open its notification details.