OmniFocus 4 Reference Manual

Inspector

This chapter needs revision, and does not fully reflect the current state of OmniFocus 4.

The inspector holds tools for editing your actions, projects, folders, and tags.

Related information can be found in the OmniFocus 3 Reference Manual for macOS and iOS.

Tap the Inspector button (a lower case i in a circle) in the outline toolbar to open the inspector. On compact devices, you can also swipe in from the right edge of the screen.

This chapter explains the purpose and function of the inspector’s various fields and options for editing your OmniFocus items.

Inspector Menu

Convert to Project

Tap Convert to open the Convert dialog, where you can convert an action to a top level project, or convert it to a project inside an existing folder. If the selected item is a project, Convert functions in reverse to change it to an action group. (The project becomes the parent action of the group, and its actions are nested inside it.)

Move

Tap Move to open the Move dialog and reposition the currently selected tag, project, action, or folder. The Move dialog provides destinations for moving the selection to another position within its hierarchy.

  • With a tag selected — Move the tag anywhere within the tag hierarchy.

  • With a project selected — Move the project anywhere within the project hierarchy (created by nesting folders). Projects live within folders but have no intrinsic hierarchical properties themselves; to move a project inside another project, first use Convert to change it to an action group, then drag the action group inside the destination project.

  • With an action or parent action selected — Move the action within its project or the Inbox, repositioning it within the action group hierarchy. To move an action to another project, use the Project row in the inspector.

  • With a folder selected — Move the folder anywhere within the project hierarchy.

Share

The Share button appears in the inspector toolbar in compact views. It works the same here as it does in the Outline.

Show All Inspector Fields

Tap Show All Inspector Fields to turn on the display of all of the available fields of the inspector, overriding other inspector layout settings. Choose this option again to restore the inspector layout to its regular state.

Edit Inspector Layout

Tap Edit Inspector Layout to open Layout Settings, where you can choose which inspector attributes you would like to show, and in which order.

Delete

Tap Delete to remove the selected item or items from your database entirely.

Inspector Tools (Compact)

In compact views, tools are available in the inspector’s toolbar to navigate between items and between the inspector and the outline.

Back (Left Arrow)

The Back button appears in the inspector toolbar in compact views. Tap it to dismiss the inspector and return to the outline.

Previous (Up Arrow)

Tap Previous to return to the item above the currently selected item in the outline.

Next (Down Arrow)

Tap Next to advance to the item below the currently selected item in the outline.

Setting Dates

Several attributes in the inspector can have dates applied or adjusted. When you tap one of them the date picker appears, presenting a calendar where you can set the date and time.

The date picker has the following controls for adjusting an attribute's date and time:

  1. Attribute — The selected attribute appears here, along with its current date value. Tap the red X to remove the attribute (and its associated date) from the item.
  2. Month and Year — Tap the month to open a scrolling picker for the month and year, or tap the right and left arrows to page through months in the calendar.
  3. Calendar — The current date is colored with the highlight color of the perspective that you are viewing, while the date that is value for the attribute is circled and set in bold. Tap a date in the calendar to change the value.
  4. Time — Tap the time field to scroll through the hour in five minute increments. Tap it again to manually enter the hour, and a third time to enter the minute. Tap the AM/PM switch to choose morning or evening time.
  5. Shortcuts — This row of buttons sets the date either to a fixed increment ahead of the current value (+1 day, +1 week, +1 month, or +1 year).

Inspector Attributes

Attributes in this section are listed in the order they appear in Inspector Layout settings.

Title

Appears For: All Items and Tags

Every item and tag in OmniFocus has a title. Tap the title text in the inspector to edit it.

Item Status

Appears For: All Items and Tags

Every item and tag in OmniFocus has a status.

  • Projects can be Active, On Hold, Completed, or Dropped. Projects have the Active status by default. For more on the meaning of each status and how it affects availability of items within the project, see Project Status.
  • Inbox items and actions can be Active, Completed, or Dropped. Inbox items and actions have the Active status by default. For more on the meaning of each status and how it affects availability of items within the project, see Item Status.
  • Tags can be Active, On Hold, or Dropped. Tags have the Active status by default. For more on the meaning of each status and how it affects availability of items the tag is assigned to, see Tag status.
  • Folders can be Active or Dropped.

The Status row also includes the Flag icon: either empty (unflagged), filled orange (flagged), or with an orange dotted outline (inherited flag). Tap to set or remove flagged status on the item.

When a flag is set on an item, it appears in the Flagged perspective. If a flag is set on a project or group, the items within it inherit the flag.

Project Type

Appears For: Projects and Groups

A row labeled Type with buttons for choosing the project type: Sequential, Parallel, or Single Actions.

Projects have the Parallel type by default. For more on the meaning of each status and how it affects availability of items within the project, see Project Type.

Groups can also have a project type. In this case, type selection in the inspector is limited to Sequential and Parallel (groups cannot have the Single Actions type).

The Project Type row also includes a switch to complete the project when the last action in the project or group is complete.

Tap the switch to toggle between two options for completing the project or group:

  • Manually — The project or group status must be changed to Completed manually, regardless of the completion status of actions within it.

  • With Last Action — The project or group status automatically changes to Completed when its last action is completed.

Projects of the Single Actions type do not display this attribute, since they have no last action and are not conventionally considered complete.

Project

Appears For: Inbox Items, Actions, and Groups

A row labeled Project followed by the project name and the Go To Project button (or None, if no project is set). Tap to assign or change the item’s project, or tap Go To Project to open the project in the outline.

The project picker can also be used to create new projects: enter an unused project title and tap Create “New Project”, and the new project will be assigned to the item.

Projects are tasks composed of the action items required to complete them. Unlike tags, an item can only be assigned to a single project at a time.

Tags

Appears For: All Items

A row labeled Tags, containing the Add Tag button as well as any tags assigned to the item.

Tags represent associations that tasks have to you and the world around them. Tap Add Tag to add an existing tag to an item, or create a new one to add: enter an unused tag name and tap Create “New Tag”, and the new tag is created and assigned.

Unlike projects, an item can be assigned as many tags as you like. When tags are assigned to an item, tap one in the inspector row to either go to or remove it.

If you have more tags on an item than fit in the row, swipe left or right to find the tag you want.

Estimated Duration

Appears For: All Items

A row labeled Estimated Duration followed by an amount of time (in minutes or hours). Tap to set or change the item’s time estimate for completion.

Estimated duration is particularly useful when setting up custom perspectives with OmniFocus Pro, where you can use this value to create perspectives for tasks that require a certain amount of time to complete.

Defer Until

Appears For: All Items

A row labeled Defer Until followed by a date and time (or None, if no defer date is set). Tap to set or change the item’s defer date.

When a defer date is set on an item, it is not considered available for action until that date is reached.

If a defer date is set on a project or group, items within it inherit that date. (A defer date set directly on the item will override the inherited date, if it is later.)

Due

Appears For: All Items

A row labeled Due followed by a date and time (or None, if no due date is set). Tap to set or change the item’s due date.

When a due date is set on an item, it is considered due at that date (and due soon based on the Due Dates settings).

If a due date is set on a project or group, items within it inherit that date. (A due date set directly on the item will override the inherited date, if it is sooner.)

Notifications

Appears For: All Items

A row labeled Notifications followed by a count of the notifications on the item (or None, if no notifications are set). Tap to view a list of notifications on the item and create new scheduled notifications.

If any notifications were created automatically for the item based on your preferences in Notifications settings, these appear in the list here.

Tap +Scheduled Notification (or +Before Due Notification, if the item is due in the future) to add a notification. To delete a notification, swipe its row in the inspector from right to left and tap Delete.

You can set as many notifications on an item as you like; when multiple notifications are set, they are listed from earliest to latest.

Scheduled Notifications

Use the Add Notification dropdown menu to create a new notification of one of the following types:

  • Before Due — Adds a notification that occurs a set amount of time before the item is due. A notification of this type depends on the item's due date, so if the due date is changed or removed the time of the notification is likewise altered.
  • Scheduled — Adds a notification at a custom date and time that you choose from the calendar that accompanies this option. This is a fixed notification that doesn't depend on any other factors, so its date and time won't change even if you change the item's other dates.

Note that while scheduled notifications are independent of other dates assigned to an item, they do obey the item's floating time zone setting.

Time Zone

Appears For: All Items

A row labeled Use Floating Time Zone. Tap to choose whether dates and times associated with the item are floating (the default for new items) or not.

  • Using a floating time zone means that your time zone location is ignored: date and time values you assign to the selection remain the same no matter which time zone you are in. (If you indicate an item is due at 5:00 PM, it will always be due at 5:00 PM no matter where you are.)

  • Choosing not to use a floating time zone means that your dates and times are associated with the time zone where they are entered. When you change time zones, OmniFocus updates the date and time values of the selection to correspond with the new time zone. (An item due at 5:00 PM Seattle time will always be due at 5:00 PM Seattle time—so if you're in New York, you'll see that time as 8:00 PM.)

Completed

Appears For: All Completed Items

A row labeled Completed followed by a date and time. Tap to change the date that the item was completed.

If the item status or project status is changed from Completed, this row disappears and the completion date is removed.

Dropped

Appears For: All Dropped Items

A row labeled Dropped followed by a date and time. Tap to change the date that the item was dropped.

If the item status or project status is changed from Dropped, this row disappears and the dropped date is removed.

Repeat

Appears For: Items other than Single Action Lists

A row labeled Repeat followed by a summary of the repeat interval (or None, if the item doesn’t repeat). Tap to set or change an item’s repeat interval.

Tap the Repeat switch to indicate that an item repeats. Items can be set to repeat based on a variety of criteria that are progressively disclosed as you make changes in the repeat editor:

  • Interval — Choose a number hours, days, weeks, or months which elapse for every repeat cycle. When weeks or months are chosen, additional custom options become available.

  • Custom: Days of Week — With an interval of weeks, the option becomes available to repeat every weekday chosen here (Monday, Wednesday, and Friday, for example). With an interval of months, the option becomes available to repeat every first through fifth (or last) weekday of the month.

  • Custom: Days in Month — With an interval of months, the option becomes available to repeat on the chosen calendar dates of the month (or the last day of the month).

  • Schedule the Next — Choose whether completing the item will schedule the next occurrence as a:

    • Due Date — The item must be completed again by that date. Or;
    • Defer Until Date — The item becomes available again on that date.
  • Repeat From This Item’s — Choose whether completing the item will schedule the next occurrence from:

    • Completion — The repeat interval begins when the item is completed. Or;
    • Assigned Dates — The repeat interval begins at the originally assigned date.

Review

Appears For: Projects

A project’s review interval and next review date are among the few attributes that all projects possess. If project review isn’t part of your workflow, feel free to ignore them.

Use the Review section of the inspector to change how often the project should be reviewed, and edit the date of a project’s next scheduled review. The default is every week, beginning a week from the project’s creation. By default, review projects every can be adjusted in the Dates & Times settings for Mac or iPhone and iPad.

Next review

The top field contains the date of the project’s next scheduled review, and can be manually adjusted, if you’d like.

Review every

Set the interval at which the project comes up for review, expressed in days, weeks, months, or years.

Last reviewed

The date the project was last reviewed. This is derived from your editing history, and can’t be changed directly.

Note and Attachments

The Note field offers a blank canvas to add as much information about the item as you like. URLs added here become interactive once the note is saved, making it possible to refer back to websites or other apps that use URL syntax. The Notes field also lists any attachments included with the item.

Tap Add Attachment to open a menu with controls for adding attachments in the following ways:

  • Attach File

  • Take Photo

  • Photo Library

  • Scan Document

  • Record Audio

OmniFocus is not intended to replace a dedicated file syncing service.

OmniFocus sync is designed to accommodate a wide range of uses, but slowness and other problems may occur when syncing large volumes of archival attachments or multiple files of great size.

If you make frequent use of the attachments feature, consider using the Attachments List in Database Settings to review the files attached to your database and remove large or unneeded files.

Added and Changed

Appears For: All Items

Two row labeled Added and Changed respectively, followed by dates and times that represent when the item was added to OmniFocus and when it was last updated. These attributes exist for reference and cannot be edited directly.

Tag Location

Appears For: All Tags

A row labeled Location followed by the location set on the tag (or None, if no location is set). Tap to set a tag’s location. The following options appear:

  • Here — Use Wi-Fi or cellular triangulation to pinpoint where you are right now, and add that as the tag location.
  • Anywhere — This isn’t really a location; instead, it means that this tag contains work you can do no matter where you are.
  • Search — Enter a search keyword (“hardware store”, for example). You can either assign the tag a location that appears as a result of the search, or use the search itself: if you use the search, the tag location becomes the location of the nearest search result at any given time.
  • Address — Enter a specific address to add as the location.
  • Contact — Choose an address from an entry in the Contacts app. If this is the first time you’ve opted to set a location this way, an alert will pop up asking you to grant OmniFocus access to your contacts.
  • Pin — Touch and hold a spot on the map to drop a pin at a location of your choice.

To remove an assigned location, tap the X next to it in the row.

When a location is assigned to a tag, it shows up in Nearby when you’re close to that location.

Setting a tag’s location doesn’t automatically mean you will receive proximity-based alerts for that tag. To receive notifications, make sure location alerts are turned on for your device in Sounds and Alerts settings, and make sure that Tag Notification Kind is set to When Arriving or When Leaving.

When a location is set, two additional attributes appear in the Location section.

A control labeled Notification that determines when the notification occurs:

  • None — You will not be notified when arriving at or leaving from the tag location.
  • When Arriving — You will be notified when you arrive at the area of the tag location.
  • When Leaving — You will be notified when you depart from the area of the tag location.

And a control labeled Distance with buttons for choosing the location’s area size.

  • Small — Roughly 200 meters or 650 feet. This covers about one city block, and is useful for things such as coming home or leaving the office.
  • Medium — Roughly 500 meters or about a quarter mile. This covers something like a small neighborhood or park, and is useful for knowing when you are a few streets over from a certain store.
  • Large — About 10 kilometers or 6.2 miles. This is useful for turning on tags that are relevant when you visit a distant city.