OmniFocus 3 Reference Manual for iOS

The Outline

The outline is where you view, add, and manipulate tasks in OmniFocus. The items you see in the outline depend on the perspective you are viewing: you can narrow your concentration on just a few things you’d like to accomplish in the near term using Forecast, tackle things contextually with Tags, or get a broad overview of the work ahead across a number of Projects.

The outline in the center pane of OmniFocus 3, full of actions and projects to work on.

In wide views, the Outline is the center pane and backdrop of all your activity in OmniFocus.

In compact views, the outline sits at a level beneath Home and the sidebar; you’ll tap through the hierarchy in a chosen perspective to reach it.

The Anatomy of a Row

A row in the OmniFocus outline represents an item—a to-do that you captured with OmniFocus—or a piece of your organizational framework like a project, folder, or tag.

Rows display all sorts of information about an item, like the project it belongs to, any relevant tags, due dates, and completion status in the form of the status circle.

The figure below is a breakdown of an item in the Inbox that’s packed with additional information about the task at hand.

An Inbox item row in OmniFocus 3 for iOS with its various components numbered from one to six.
  1. Project—If the item has a project assigned, its location in the project hierarchy appears here. Since this is an Inbox item (and Inbox items with projects are usually cleaned up), this item is listed with No Project. This row does not appear on items in the Projects perspective or custom perspectives that display project hierarchy, and can be hidden in the Inbox view options button, a grey eye View Options to increase the number of items on screen at once.

  2. Title—The item’s title. Black title text generally indicates that an item is actionable; items that are completed, blocked, on hold, or parents of groups have grey title text instead (unless they are due soon or overdue).

  3. Notes and Attachments—These icons indicate whether the item includes notes the Notes icon, a grey ruled sheet of paper or attachments the Attachments icon, a paper clip.

  4. Tags—Any tags assigned to the item appear here. An item can have as many tags as you want; if there are more tags than horizontal space in the row, additional tags are indicated by an ellipsis.

  5. Dates—If the item has due or defer dates assigned, they will appear here when relevant (once a defer date has passed it is no longer displayed). The defer date may be hidden if there isn’t enough room in the row.

  6. Status Circle—A visual representation of the completion status of the item, along with other important attributes. Tap an active item’s status circle to mark it complete.

Project, Folder, and Tag Rows

In addition to the common attributes of Inbox items, rows for projects, folders, and tags can have a variety of other useful information.

Note that hierarchy (projects nested within folders and tags within other tags) appears by default in the outline on wide devices; on compact, tap Show Projects Contents or Show Tags Contents to browse the full perspective hierarchy. Otherwise, each level of hierarchy is represented sequentially as you navigate through it.

A folder and a project within it in the Projects perspective, with various other row components numbered one through six.
  1. Disclosure Triangle—Tap to collapse or expand the folder, project, or tag to hide or reveal its contents.

  2. Row Type Icon—Projects, the folder icon, a grey folder folders, and the tag icon, a grey tag tags have icons next to them to help remind you of your current perspective and the row’s relation to those around it. Projects are further broken down by type: the sequential project icon, a line of three joined dots Sequential, the parallel project icon, two parallel dotted lines Parallel, and the single action list icon, four unconnected dots in a diamond Single Actions.

  3. Row Status—Projects and tags with a status other than Active display it here. In addition to Active (no icon), Projects can be On Hold the On Hold icon, two blue vertical bars, Completed the Completed icon, a purple check mark, or Dropped the Dropped icon, a red X, while tags can be Active, On Hold, or Dropped.

  4. Item Count—The total number of items in the project, folder, or tag.

  5. Notes and Attachments—Indicates whether there are notes or attachments associated with the project itself (as opposed to the items within it). Notes and attachments can’t be assigned to folders or tags.

  6. Due Summary—When there is enough room in the row, this line shows a breakdown of the due states (due soon and overdue) of items in the project, folder, or tag.

Status Circle

An item’s status circle is the target for checking it off when it is done. Tap the circle the grey default status circle, and the item is complete the checked solid completed status circle. (What happens next depends on your Clean Up setting.)

Status circles also convey important information about an item: items can be due soon the amber due soon status circle (amber), overdue the red overdue status circle (red), or flagged the orange flagged status circle (orange). Repeating items are distinguished by the ellipsis the grey ellipsis status circle in their center, and items that are dropped receive a grey cross bar the grey cross bar dropped status circle.

If you have an item with more than one status, the circle will take on multiple colors simultaneously to communicate each relevant attribute.

Outline Tools

The outline toolbar and bottom bar contain a variety of tools for determining what gets displayed in the outline, editing multiple items at once, adding new items to the outline, reverting unwanted changes, and managing projects in the Review perspective.

View Options the Inbox view options button, a grey eye

Tap View Options to customize which items appear in the current perspective’s outline view based on their completion status, project order, and other perspective-specific features.

Edit

Tap Edit to enter Edit mode, where you can adjust the properties of multiple items at once.

Back the Inbox Back button, a chevron pointing left

In compact views, tap Back to return to the previous level in your OmniFocus directory. (The button’s label changes to Home when at the top level of another perspective, or to the perspective’s name when a level below that.)

Instead of tapping Back repeatedly, you can tap and hold it to return Home in an instant.

Inspector the Inbox Inspector button, an italicized I in a circle

In wide views, tap Inspector to open and close the inspector on the right side of OmniFocus. In compact views, the Inspector button appears in the toolbar while in Edit mode. (Both views can use the inspector to batch edit items while in Edit mode.)

Share The Share button is an arrow emerging from a round-cornered square

Tap Share to send a selected item outside of OmniFocus using the iOS Share dialog. The item is added in a format relevant to its destination, with a link back to the original item in OmniFocus (or to add the item in OmniFocus, if sent via Mail).

With OmniFocus Pro, any Omni Automation Plug-Ins you have installed also appear as options in the Share dialog. Tap a scripted action in the list to run it.

Clean Up the Inbox Clean Up button, a grey dusting brush

In wide views, tap Clean Up to tidy any items in the outline that may belong elsewhere after a change of project, tag, or status. In compact views, drag down on the outline to prompt a clean up.

Use Clean Up Settings to determine when items are removed from the outline automatically.

In wide views, tap Sidebar to open and close the sidebar on the left side of OmniFocus. In compact views, tap the Inbox Back button, a chevron pointing left Back to return to the sidebar and Home.

New Inbox Item The New Inbox Item button is a tray with a plus sign above it

Tap New Inbox Item to quickly add items to the Inbox, or tap and hold the button’s icon to drag it anywhere in the outline. As you drag the button over the outline, rows around it separate to provide a blank space to drop it. Drop the button to create a new item at that spot in the outline hierarchy, pre-filled with any relevant attributes based on the perspective you’re in.

The editor that appears when you tap New Inbox Item The New Inbox Item button is a tray with a plus sign above it is functionally identical to the inspector for Inbox items, and contains the same attributes and controls.

Create New...

The Create New buttons are available when viewing a relevant perspective in the outline. Tap to add an item of the chosen type (Project The create new project button, Folder The create new folder button, or Tag The create new tag button ) at the top level of on-screen hierarchy. (If you’re looking at the contents of a folder and tap Create New Folder, for instance, the folder will be created inside the current folder.)

Add Here The Add Here button in the Projects perspective

The Add Here button is available when viewing the contents of a single project, tag, or other flat list (such as the Flagged perspective or a date in Forecast). Tap it to add an action item at the current location.

Add Here only appears when viewing the contents of a flat list in the outline. If the view includes anything else—a folder, a nested tag—it isn’t specific enough to know what “here” means, so the button won’t appear.

Undo The Undo button is an arrow looped back

Undo is available wherever you are in the outline. Tap it to revert the most recent change to your database. After a change has been undone, this button changes to Undo/Redo the Undo/Redo button is two interlocking arrows and provides the option to restore the undone change.

Review Buttons

These buttons are available in the bottom bar of the Review perspective, and have specific uses pertaining to the review process.

  • The Previous button in the Review perspective outline bottom bar Previous—Return to the previous project in the list for review.
  • The Next button in the Review perspective outline bottom bar Next—Advance to the next project in the list for review.
  • The Mark Reviewed button in the Review perspective outline bottom bar Mark Reviewed—Mark the current project as reviewed, and advance to the next project in the list. The project’s next review date is updated to the present plus its review interval.

Contextual Menus

Contextual menus appear when you tap and hold a row in the outline, and contain commands contextually relevant to your selection.

The contextual menu on a project in the outline.

Tap and hold is the same gesture required to lift an item for drag and drop. Instead of moving the item elsewhere in the outline, release it after it lifts and the contextual menu will appear.

On Actions

Depending on their attributes, contextual menus for actions and Inbox items include the following commands:

  • Cut—Cut the item from the database and copy it to the pasteboard.
  • Copy—Copy the item to the pasteboard.
  • Paste—Add the contents of the pasteboard beneath the selected item.
  • Share—Open the iOS Share dialog to send the selection to another app or run an Omni Automation Plug-In or other action.
  • Delete—Delete the item from the database entirely.
  • Forecast Tag—Add or remove the Forecast tag An icon indicating that this feature is part of OmniFocus Pro., if one is set.
  • Flag/Unflag—Add or remove Flagged status.
  • Drop/Skip—Set the item's status to Dropped, or skip the current iteration of a repeating item.
  • Due Today/Reschedule to Today—Set the item's due date to today, or reschedule the current iteration of a repeating item to today.
  • Due Tomorrow/Reschedule to Tomorrow—Set the item's due date to tomorrow, or reschedule the current iteration of a repeating item to tomorrow.
  • Defer until Tomorrow—Set the item's defer date to tomorrow.

On Projects

Depending on their attributes and location (sidebar or outline), contextual menus for projects include the following commands:

  • Expand All—Expand all items in the outline to show their contents.
  • Collapse All—Collapse all items in the outline to show only the top level projects and folders.
  • Share—Open the iOS Share dialog to send the selection to another app or run an Omni Automation Plug-In or other action.
  • Forecast Tag—Add or remove the Forecast tag An icon indicating that this feature is part of OmniFocus Pro., if one is set.
  • Flag/Unflag—Add or remove Flagged status.
  • Drop—Set the project's status to Dropped.
  • Due Today—Set the project's due date to today.
  • Due Tomorrow—Set the project's due date to tomorrow.
  • Defer until Tomorrow—Set the project's defer date to tomorrow.
  • Go to Project—Navigate to the project in the outline.
  • Paste—Add the contents of the pasteboard as items within the project.
  • Review—Open the project in the Review perspective.
  • New Action—Add a new action to the project.
  • Delete—Delete the project and all of its actions from the database entirely.
  • Open in New Window (iPadOS only)—Open the project in a new window.

On Folders

Depending on their location (sidebar or outline), contextual menus for folders include the following commands:

  • Expand All—Expand all items in the outline to show their contents.
  • Collapse All—Collapse all items in the outline to show only the top level projects and folders.
  • Share—Open the iOS Share dialog to send the selection to another app or run an Omni Automation Plug-In or other action.
  • Go to Folder—Navigate to the folder in the outline.
  • New Folder—Add a new folder inside the selected folder.
  • New Project—Add a new project inside the selected folder.
  • Delete—Delete the folder and its contents from the database entirely.
  • Open in New Window (iPadOS only)—Open the folder in a new window.

On Tags

Depending on their location (sidebar or outline), contextual menus for tags include the following commands:

  • Expand All—Expand all tags to show the nested tags and items within them.
  • Collapse All—Collapse all tags to show only top level tags in the outline.
  • Share—Open the iOS Share dialog to send the selection to another app or run an Omni Automation Plug-In or other action.
  • Go to Tag—Navigate to the tag in the outline.
  • Paste—Add the contents of the pasteboard as items with the tag assigned.
  • New Tag—Add a new tag inside the selected tag.
  • New Action—Add a new action inside the selected tag.
  • Delete—Delete the tag and its associated items from the database entirely.
  • Open in New Window (iPadOS only)—Open the tag in a new window.

Navigate to the top of the outline and drag down to reveal the Search bar. Tap Search and enter keywords to find matching items from among three different possible scopes on your database.

The Search bar, hidden beneath the toolbar in the Projects perspective, and the three scopes available for search when a term is entered.
  • Here—The search is limited to the content currently visible in the outline. For many perspectives this includes the entire content of the perspective, but for those with hierarchy it may not—if you’re viewing the contents of a specific project or folder, items in projects outside that scope will not be shown in the results.

  • Remaining—The search includes everything in your database with an implicit status of Remaining: all items except those marked Completed or Dropped.

  • Everything—The search includes every item in your database, regardless of status or location.

Search looks for text matching the keywords in item titles, notes, and tags, and displays results as a list of items in the outline.

Edit Mode

Tap Edit in the outline toolbar to enter Edit mode. In Edit mode, you can select, inspect, and edit as many items simultaneously as you would like. (Tap rows in the outline to select them.)

The three pane layout in Edit mode.

Any attributes shared by the selected items are displayed in the inspector. When attributes differ, the inspector indicates this as well (items selected across projects display as Mixed, a collection of flagged and unflagged items displays Some Items Flagged, and so on).

Editing an attribute of the selection applies the edit to all items in the selection, overwriting any existing information (in the case of Some Items Flagged, for example, tapping to flag the selection applies a flag directly to all items in the selection).

Any property shared by items in the selection can be edited using the inspector, or tap Delete the Delete button is a trash can to delete the selection from your database entirely.

In addition to the inspector’s editing controls, tap More in the outline’s bottom bar for several other batch editing tools (in the widest outline view these appear in the bottom bar side by side).

  • Flag/Unflag—Add or remove Flagged status to the items in the selection.

  • Tag—Add a tag to the items in the selection. A sheet appears with a list of existing tags and the option to create a new one from text in the Search dialog.

  • Remove Tag—Remove a tag from items in the selection. A sheet appears with a list of tags shared by one or more of the selected items.

  • Group—Create a group consisting of the selected items and a new parent item. The group appears in the hierarchy on a peer row of the first item in the selection, directly above it.

  • Cut—Cut the items from the database and copy them to the pasteboard. Leave Edit mode and tap and hold a row to open the contextual menu and paste the copied items beneath it.

  • Copy—Copy the items to the pasteboard. Leave Edit mode and tap and hold a row to open the contextual menu and paste the copied items beneath it.

  • Delete—Delete the items from the database entirely.

When you are finished editing, tap Done in the toolbar to leave Edit mode.

Drag and Drop

Items in the outline can be repositioned within the outline hierarchy, dragged to other projects or tags in the sidebar, and dragged from OmniFocus to other applications (where they are added in plain text TaskPaper format).

To select an item for drag and drop, tap and hold its row in the outline until the item “lifts off the page” and transforms into a mobile selection under your finger.

Dragging and dropping a multi-item selection in the Projects perspective.

Once lifted, you can add additional items to the selection by tapping their rows. Additional items animate to join the selection, and the badge count increments to indicate the total number of items being dragged. When you drag a project or tag, the selection includes all of the items inside it.

If you would like to add items to the selection that are off screen, swipe to scroll the outline with a second finger while holding the selection with the first.