Leaving an app

How to export your data from OmniFocus

On iPhone or iPad, use Export to CSV in OmniFocus’s Database settings. On a Mac, choose File, then Export, and pick Plain Text (TaskPaper style), Simple HTML, CSV, an OmniFocus document or a backup document. Plain text is the easiest to read and move; CSV opens in a spreadsheet. Completed items you archived live in a separate Archive file, so open and keep that too before you stop using OmniFocus.

Coming soon to iPhone and iPad

Last checked

On this page

The Omni Group’s manual puts it plainly: your OmniFocus data belongs to you, and you are welcome to export it in the format you like. What you can choose depends on the device.

Export on iPhone or iPad

OmniFocus offers one format on iPhone, iPad and Apple Vision Pro: CSV.

  1. Open OmniFocus and go to its settings.
  2. Open Database settings.
  3. Choose Export to CSV, and save the file to Files or iCloud Drive.

A CSV is a spreadsheet: one row per item, with columns for its details. It opens in Numbers or Excel, which makes it easy to check, sort and copy from.

Export on a Mac

Choose File, then Export, pick a format and a place to save. The manual lists five:

Format What it is Use it for
Plain Text A light text version inspired by TaskPaper Reading anywhere, and moving to a simpler app
Simple HTML One web page with styles and icons inside A readable archive you open in a browser
CSV and CSV UTF-16 A spreadsheet file Sorting, scripts, other apps; use UTF-16 if accented letters come out wrong
OmniFocus Document A normal OmniFocus file in its own window Moving items between OmniFocus databases
Backup Document An .ofocus-backup file Restoring OmniFocus later with Revert to This Backup

What plain text looks like

The plain text export follows TaskPaper’s style. Projects and actions are indented lines, and each item’s details come after it as parameters such as @defer(...), @due(...), @done(...), @flagged, @tags(...) and repeat rules. To see exactly how one item comes out, select it and choose Edit, then Copy as TaskPaper, and paste into a text editor.

This is the most portable copy, because it is text. It keeps dates and tags as words you can read, even if the next app ignores them.

Find your backups and your Archive

Two things often get left behind:

  • Backups. On a Mac, OmniFocus backs up every two hours while it runs and keeps up to 100 backups; choose File, then Show Backups in Finder. On iPhone and iPad, it backs up once a day, to the device or to iCloud Drive, set in Database settings. These are for restoring OmniFocus, not for reading.
  • The Archive. On a Mac, Archive Old Items moves completed and dropped items into a separate Archive file, which you choose a folder for. If you archived for years, much of your history is there, not in your main database. Choose File, then Open Archive, to look, and copy the Archive.ofocus-archive file into your export folder.

Keep a copy safe

  1. Export plain text and CSV from the Mac, or CSV from your iPhone.
  2. Copy the latest backup document and your Archive file next to them.
  3. Open the plain text and a few CSV rows to check dates and projects came through.
  4. Keep the folder somewhere backed up, named with the date. Backing up your to-dos and notes covers where.

Before you stop using OmniFocus

  • Sync. If you use Omni Sync Server, make the export from a device that has synced recently, so it holds your latest changes.
  • Subscription. If you pay through the App Store, cancel in Settings, your name, Subscriptions on your iPhone; our guide to cancelling a subscription on iPhone has Apple’s steps. If you pay The Omni Group directly, your receipt shows where to manage it.
  • Perspectives. None of the export formats is described as holding your custom perspectives, so write down how the ones you rely on are set up.

Where Dozen helps, and where it doesn’t

Dozen can take your open actions from OmniFocus’s plain text, once it is tidied. Dozen reads a plain list in text or Markdown, which is the way in from Things, Notes and Reminders. In a plain list, a line is a to-do, an indented line is a step of the one above it, one hash names the project and two hashes start a heading. Turn each project line into a # Project line, keep one action per line, indent sub-actions by two spaces, and remove the @ parameters, writing any date that matters in plain words. Settings, Data, Import Tasks reads the file you choose, shows what it found, and only then adds anything. Dozen does not read OmniFocus files, CSV exports or TaskPaper parameters, and we have not tested them. Moving to Dozen shows the format. A to-do can have a day to do it, a deadline and a repeat, each set from its own panel. A to-do can be set to Someday, which puts it on hold without a date.

Where it does not help: OmniFocus has defer dates, sequential projects, custom perspectives and a review system that Dozen does not try to match. Dozen is not on the Mac yet, has no web app, and is not on the App Store yet. If those OmniFocus tools hold your system together, read Dozen vs OmniFocus before moving, or keep OmniFocus and keep your exports current.

Questions and answers

Can I export OmniFocus from my iPhone?

Yes, as CSV. The OmniFocus manual says exporting on iPhone, iPad or Apple Vision Pro offers the CSV format, through Export to CSV in Database settings. The other formats, including plain text, are on the Mac.

What is the difference between a backup and an export?

A backup is for OmniFocus: you open it and choose Revert to This Backup. An export is for everything else: plain text, HTML or CSV that other apps and people can read. Keep one of each if you can.

Sources

What this page says about Dozen was checked against the app on .

Last checked:

Get Dozen

Dozen is free to download. Dozen Pro, a monthly or yearly subscription, adds the Assistant.

Coming soon to iPhone and iPad

Dozen: Tasks & Notes

Dozen is free to download. Dozen Pro, a monthly or yearly subscription, adds the Assistant.

Coming soon to iPhone and iPad